AIHive · Agent World

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_1636":1637,"_1638":1639},"routes/_app.x.$handle.$name",{"_101":100,"_32":46,"_109":91,"_27":110,"_13":14,"_111":-5,"_11":112,"_113":114,"_115":116,"_117":118,"_119":120,"_20":-5,"_121":-5,"_122":-5,"_123":25,"_124":125,"_126":60,"_127":-5,"_128":-5,"_129":130},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":84,"_85":86,"_87":88,"_89":25},"version",1003,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","api/marketing.ts","latestPath","fileId","239b0f08-5f0f-11f1-83c8-1607ee4eb77e","name","marketing.ts","fileType","script","content","import { sqlite, currentTenantId } from \"../db.ts\";\nimport { getAIOKpis, getFunnelSummary } from \"./intelligence.ts\";\nimport { getAttributionSummary } from \"./aio.ts\";\nimport { getCompanyProfile } from \"./company.ts\";\n\n// Marketing backend — the genuinely-new bits of the Wave-1 Marketing operating surface.\n// Most of the Marketing tab SURFACES existing capability (funnel-summary, AIO KPIs, attribution,\n// recommendations, nurture sequences, enrichment). This file adds only what had no home:\n// • getMarketingOverview() — composes the KPI-header payload from the existing AIO KPIs +\n// funnel-summary + attribution-summary into one bundle for /api/marketing/overview.\n// • personas CRUD + importPersonasFromEnrichment() — the Audiences (ICP/persona/segment) library\n// backed by marketing_personas (db.ts). Import reads enrichCompanyProfile/company profile\n// output and upserts rows non-destructively.\n// • utm CRUD (+ full_url builder) — saved campaign-tagged links backed by utm_links (db.ts).\n// • brand kit get/save — one row per tenant (upsert) backed by brand_kit (db.ts).\n// All queries tenant-scoped (WHERE tenant_id = currentTenantId(); INSERT/UPSERT sets tenant_id).\n// Mirrors api/accounts.ts patterns (rowToObj / JSON-text columns / hydrate).\n\nfunction rowToObj(columns: string[], row: any[]): Record {\n const o: Record = {};\n for (let i = 0; i < columns.length; i++) o[columns[i]] = row[i];\n return o;\n}\n\nfunction toJsonObject(v: any): Record {\n if (v && typeof v === \"object\" && !Array.isArray(v)) return v;\n if (v == null || v === \"\") return {};\n try { const p = JSON.parse(String(v)); return p && typeof p === \"object\" && !Array.isArray(p) ? p : {}; } catch { return {}; }\n}\n\nfunction serializeAttributes(v: any): string {\n return JSON.stringify(toJsonObject(v));\n}\n\n// ─── OVERVIEW (KPI-header bundle) ────────────────────────────────────────────\n// Compose the existing AIO unit-economics KPIs + the TOFU/MOFU/BOFU funnel summary +\n// the per-channel attribution summary into ONE object the KPI header / Overview view reads.\n// Each source is independently guarded so one failing feed degrades to null rather than 500.\nexport async function getMarketingOverview(): Promise<{\n kpis: any | null;\n funnel: any | null;\n attribution: any | null;\n generatedAt: string;\n}> {\n const [kpis, funnel, attribution] = await Promise.all([\n getAIOKpis().catch(() => null),\n getFunnelSummary().catch(() => null),\n getAttributionSummary().catch(() => null),\n ]);\n return { kpis, funnel, attribution, generatedAt: new Date().toISOString() };\n}\n\n// ─── PERSONAS (ICP / persona / segment library) ──────────────────────────────\nconst PERSONA_KINDS = new Set([\"icp\", \"persona\", \"segment\"]);\n\nfunction hydratePersona(p: Record): Record {\n return { ...p, attributes: toJsonObject(p.attributes) };\n}\n\n// List the Audiences library, ICP first then persona then segment, newest within each kind.\nexport async function listPersonas(kind?: string): Promise {\n const tid = currentTenantId();\n const params: any[] = [tid];\n let where = \"WHERE tenant_id = ?\";\n if (kind && PERSONA_KINDS.has(kind)) { where += \" AND kind = ?\"; params.push(kind); }\n const r = await sqlite.execute(\n `SELECT * FROM marketing_personas ${where}\n ORDER BY CASE kind WHEN 'icp' THEN 0 WHEN 'persona' THEN 1 WHEN 'segment' THEN 2 ELSE 3 END,\n updated_at DESC, name COLLATE NOCASE ASC`,\n params,\n );\n return (r.rows || []).map((row: any[]) => hydratePersona(rowToObj(r.columns, row as any[])));\n}\n\nexport async function getPersona(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"SELECT * FROM marketing_personas WHERE id = ? AND tenant_id = ?\", [id, tid]);\n if (!r.rows || r.rows.length === 0) return null;\n return hydratePersona(rowToObj(r.columns, r.rows[0] as any[]));\n}\n\nexport async function createPersona(data: Record): Promise {\n const id = crypto.randomUUID();\n const now = new Date().toISOString();\n const kind = PERSONA_KINDS.has(data.kind) ? data.kind : \"persona\";\n await sqlite.execute(\n `INSERT INTO marketing_personas (id, name, kind, description, attributes, source, created_at, updated_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?)`,\n [\n id, data.name ?? null, kind, data.description ?? null,\n serializeAttributes(data.attributes),\n data.source === \"enrichment\" ? \"enrichment\" : \"manual\",\n now, now, currentTenantId(),\n ],\n );\n return getPersona(id);\n}\n\nexport async function updatePersona(id: string, data: Record): Promise {\n const tid = currentTenantId();\n const existing = await sqlite.execute(\"SELECT * FROM marketing_personas WHERE id = ? AND tenant_id = ?\", [id, tid]);\n if (!existing.rows || existing.rows.length === 0) return null;\n const cur = rowToObj(existing.columns, existing.rows[0] as any[]);\n const merged = {\n name: data.name ?? cur.name,\n kind: PERSONA_KINDS.has(data.kind) ? data.kind : cur.kind,\n description: data.description ?? cur.description,\n attributes: data.attributes !== undefined ? serializeAttributes(data.attributes) : cur.attributes,\n };\n await sqlite.execute(\n `UPDATE marketing_personas SET name=?, kind=?, description=?, attributes=?, updated_at=? WHERE id=? AND tenant_id=?`,\n [merged.name, merged.kind, merged.description, merged.attributes, new Date().toISOString(), id, tid],\n );\n return getPersona(id);\n}\n\nexport async function deletePersona(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"DELETE FROM marketing_personas WHERE id = ? AND tenant_id = ?\", [id, tid]);\n return Number((r as any)?.rowsAffected ?? 0) > 0;\n}\n\n// Import ICP / persona / segment rows from the company-enrichment output (company profile).\n// NON-DESTRUCTIVE: it never deletes existing rows. It upserts one 'enrichment'-sourced row per\n// derived audience, matched on (kind, name) so re-running refreshes rather than duplicates;\n// manual rows and prior content are left untouched. The profile's `icp` field is free-form text\n// (\"ideal customer profile, segments, personas\"); we capture it as the canonical ICP row and\n// also lift `markets`/`competitors` into segment context so the library has real, sourced content.\nexport async function importPersonasFromEnrichment(): Promise<{ imported: number; personas: any[] }> {\n let profile: any = {};\n try {\n // Prefer the live-synthesized profile; fall back to the stored one. Import lazily so this\n // module doesn't hard-depend on the LLM-heavy enrichment path at load time.\n const mod = await import(\"./company-enrichment.ts\").catch(() => null as any);\n if (mod?.enrichCompanyProfile) profile = await mod.enrichCompanyProfile().catch(() => ({}));\n } catch { /* fall through to stored profile */ }\n if (!profile || Object.keys(profile).length === 0) {\n profile = await getCompanyProfile().catch(() => ({}));\n }\n\n const candidates: Array<{ name: string; kind: string; description: string; attributes: Record }> = [];\n const icpText = String(profile?.icp ?? \"\").trim();\n if (icpText) {\n candidates.push({\n name: profile?.name ? `${profile.name} ICP` : \"Ideal Customer Profile\",\n kind: \"icp\",\n description: icpText,\n attributes: {\n product: profile?.product ?? null,\n value_proposition: profile?.value_proposition ?? null,\n },\n });\n }\n const markets = String(profile?.markets ?? \"\").trim();\n if (markets) {\n candidates.push({\n name: \"Target markets\",\n kind: \"segment\",\n description: markets,\n attributes: { source_field: \"markets\" },\n });\n }\n const competitors = String(profile?.competitors ?? \"\").trim();\n if (competitors) {\n candidates.push({\n name: \"Competitive landscape\",\n kind: \"segment\",\n description: competitors,\n attributes: { source_field: \"competitors\" },\n });\n }\n\n const tid = currentTenantId();\n const out: any[] = [];\n for (const c of candidates) {\n // Match on (kind, name) within tenant to upsert non-destructively.\n const existing = await sqlite.execute(\n \"SELECT id FROM marketing_personas WHERE tenant_id = ? AND kind = ? AND name = ? LIMIT 1\",\n [tid, c.kind, c.name],\n );\n const now = new Date().toISOString();\n if (existing.rows && existing.rows.length > 0) {\n const id = String((existing.rows[0] as any[])[0]);\n await sqlite.execute(\n `UPDATE marketing_personas SET description=?, attributes=?, source='enrichment', updated_at=? WHERE id=? AND tenant_id=?`,\n [c.description, serializeAttributes(c.attributes), now, id, tid],\n );\n out.push(await getPersona(id));\n } else {\n const id = crypto.randomUUID();\n await sqlite.execute(\n `INSERT INTO marketing_personas (id, name, kind, description, attributes, source, created_at, updated_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?)`,\n [id, c.name, c.kind, c.description, serializeAttributes(c.attributes), \"enrichment\", now, now, tid],\n );\n out.push(await getPersona(id));\n }\n }\n return { imported: out.length, personas: out };\n}\n\n// ─── UTM LINKS (campaign-tagged URL builder) ─────────────────────────────────\n// Compose base_url + utm_* params into a single canonical full_url. Existing query string on the\n// base is preserved; utm_* values are appended/overwritten via URLSearchParams so the result is a\n// valid, encoded URL. Falls back to a manual join when base isn't a parseable absolute URL.\nfunction buildFullUrl(base: string, params: Record): string {\n const baseStr = String(base ?? \"\").trim();\n const pairs: Array<[string, string]> = [];\n for (const key of [\"utm_source\", \"utm_medium\", \"utm_campaign\", \"utm_term\", \"utm_content\"]) {\n const v = (params[key] ?? \"\").toString().trim();\n if (v) pairs.push([key, v]);\n }\n if (!baseStr) return \"\";\n try {\n const u = new URL(baseStr);\n for (const [k, v] of pairs) u.searchParams.set(k, v);\n return u.toString();\n } catch {\n // Not an absolute URL — append manually, respecting any existing query string.\n if (pairs.length === 0) return baseStr;\n const qs = pairs.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join(\"&\");\n return baseStr + (baseStr.includes(\"?\") ? \"&\" : \"?\") + qs;\n }\n}\n\nexport async function listUtmLinks(): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\n \"SELECT * FROM utm_links WHERE tenant_id = ? ORDER BY created_at DESC\",\n [tid],\n );\n return (r.rows || []).map((row: any[]) => rowToObj(r.columns, row as any[]));\n}\n\nexport async function getUtmLink(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"SELECT * FROM utm_links WHERE id = ? AND tenant_id = ?\", [id, tid]);\n if (!r.rows || r.rows.length === 0) return null;\n return rowToObj(r.columns, r.rows[0] as any[]);\n}\n\nexport async function createUtmLink(data: Record): Promise {\n const id = crypto.randomUUID();\n const now = new Date().toISOString();\n const full_url = buildFullUrl(data.base_url, {\n utm_source: data.utm_source,\n utm_medium: data.utm_medium,\n utm_campaign: data.utm_campaign,\n utm_term: data.utm_term,\n utm_content: data.utm_content,\n });\n await sqlite.execute(\n `INSERT INTO utm_links (id, name, base_url, utm_source, utm_medium, utm_campaign, utm_term, utm_content, full_url, created_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?,?,?)`,\n [\n id, data.name ?? null, data.base_url ?? null,\n data.utm_source ?? null, data.utm_medium ?? null, data.utm_campaign ?? null,\n data.utm_term ?? null, data.utm_content ?? null, full_url, now, currentTenantId(),\n ],\n );\n return getUtmLink(id);\n}\n\nexport async function deleteUtmLink(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"DELETE FROM utm_links WHERE id = ? AND tenant_id = ?\", [id, tid]);\n return Number((r as any)?.rowsAffected ?? 0) > 0;\n}\n\n// ─── BRAND KIT (one row per tenant — upsert) ─────────────────────────────────\nfunction hydrateBrandKit(k: Record): Record {\n // SQL column is brand_values (\"values\" is a reserved word); expose it to the API as `values`.\n const { brand_values, ...rest } = k;\n return { ...rest, values: brand_values ?? null, palette: toJsonObject(k.palette) };\n}\n\n// Return the single brand_kit row for the tenant, or an honest empty shell when none saved yet.\nexport async function getBrandKit(): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"SELECT * FROM brand_kit WHERE tenant_id = ? LIMIT 1\", [tid]);\n if (!r.rows || r.rows.length === 0) {\n return {\n id: null, voice: null, tone: null, values: null, dos: null, donts: null,\n boilerplate: null, palette: {}, logo_url: null, updated_at: null, tenant_id: tid,\n };\n }\n return hydrateBrandKit(rowToObj(r.columns, r.rows[0] as any[]));\n}\n\n// Upsert the single brand_kit row for the tenant. Partial patches merge with the existing row so\n// editing one field never wipes the others. palette is stored as JSON text.\nexport async function saveBrandKit(patch: Record): Promise {\n const tid = currentTenantId();\n const now = new Date().toISOString();\n const existing = await sqlite.execute(\"SELECT * FROM brand_kit WHERE tenant_id = ? LIMIT 1\", [tid]);\n const hasRow = existing.rows && existing.rows.length > 0;\n const cur = hasRow ? rowToObj(existing.columns, existing.rows[0] as any[]) : {};\n\n const merged = {\n voice: patch.voice ?? cur.voice ?? null,\n tone: patch.tone ?? cur.tone ?? null,\n values: patch.values ?? cur.brand_values ?? null,\n dos: patch.dos ?? cur.dos ?? null,\n donts: patch.donts ?? cur.donts ?? null,\n boilerplate: patch.boilerplate ?? cur.boilerplate ?? null,\n palette: patch.palette !== undefined\n ? JSON.stringify(toJsonObject(patch.palette))\n : (cur.palette ?? JSON.stringify({})),\n logo_url: patch.logo_url ?? cur.logo_url ?? null,\n };\n\n if (hasRow) {\n await sqlite.execute(\n `UPDATE brand_kit SET voice=?, tone=?, brand_values=?, dos=?, donts=?, boilerplate=?, palette=?, logo_url=?, updated_at=? WHERE id=? AND tenant_id=?`,\n [merged.voice, merged.tone, merged.values, merged.dos, merged.donts, merged.boilerplate,\n merged.palette, merged.logo_url, now, String(cur.id), tid],\n );\n } else {\n await sqlite.execute(\n `INSERT INTO brand_kit (id, voice, tone, brand_values, dos, donts, boilerplate, palette, logo_url, updated_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?,?,?)`,\n [crypto.randomUUID(), merged.voice, merged.tone, merged.values, merged.dos, merged.donts,\n merged.boilerplate, merged.palette, merged.logo_url, now, tid],\n );\n }\n return getBrandKit();\n}\n","import { sqlite, currentTenantId } from \"../db.ts\";\nimport { getAIOKpis, getFunnelSummary, getLeadScores } from \"./intelligence.ts\";\nimport { getAttributionSummary } from \"./aio.ts\";\nimport { getCompanyProfile } from \"./company.ts\";\nimport { createDeal } from \"./deals.ts\";\nimport { setLeadStatus } from \"./leads_crm.ts\";\n\n// Marketing backend — the genuinely-new bits of the Wave-1 Marketing operating surface.\n// Most of the Marketing tab SURFACES existing capability (funnel-summary, AIO KPIs, attribution,\n// recommendations, nurture sequences, enrichment). This file adds only what had no home:\n// • getMarketingOverview() — composes the KPI-header payload from the existing AIO KPIs +\n// funnel-summary + attribution-summary into one bundle for /api/marketing/overview.\n// • personas CRUD + importPersonasFromEnrichment() — the Audiences (ICP/persona/segment) library\n// backed by marketing_personas (db.ts). Import reads enrichCompanyProfile/company profile\n// output and upserts rows non-destructively.\n// • utm CRUD (+ full_url builder) — saved campaign-tagged links backed by utm_links (db.ts).\n// • brand kit get/save — one row per tenant (upsert) backed by brand_kit (db.ts).\n// All queries tenant-scoped (WHERE tenant_id = currentTenantId(); INSERT/UPSERT sets tenant_id).\n// Mirrors api/accounts.ts patterns (rowToObj / JSON-text columns / hydrate).\n\nfunction rowToObj(columns: string[], row: any[]): Record {\n const o: Record = {};\n for (let i = 0; i < columns.length; i++) o[columns[i]] = row[i];\n return o;\n}\n\nfunction toJsonObject(v: any): Record {\n if (v && typeof v === \"object\" && !Array.isArray(v)) return v;\n if (v == null || v === \"\") return {};\n try { const p = JSON.parse(String(v)); return p && typeof p === \"object\" && !Array.isArray(p) ? p : {}; } catch { return {}; }\n}\n\nfunction serializeAttributes(v: any): string {\n return JSON.stringify(toJsonObject(v));\n}\n\n// ─── OVERVIEW (KPI-header bundle) ────────────────────────────────────────────\n// Compose the existing AIO unit-economics KPIs + the TOFU/MOFU/BOFU funnel summary +\n// the per-channel attribution summary into ONE object the KPI header / Overview view reads.\n// Each source is independently guarded so one failing feed degrades to null rather than 500.\nexport async function getMarketingOverview(): Promise<{\n kpis: any | null;\n funnel: any | null;\n attribution: any | null;\n generatedAt: string;\n}> {\n const [kpis, funnel, attribution] = await Promise.all([\n getAIOKpis().catch(() => null),\n getFunnelSummary().catch(() => null),\n getAttributionSummary().catch(() => null),\n ]);\n return { kpis, funnel, attribution, generatedAt: new Date().toISOString() };\n}\n\n// ─── PERSONAS (ICP / persona / segment library) ──────────────────────────────\nconst PERSONA_KINDS = new Set([\"icp\", \"persona\", \"segment\"]);\n\nfunction hydratePersona(p: Record): Record {\n return { ...p, attributes: toJsonObject(p.attributes) };\n}\n\n// List the Audiences library, ICP first then persona then segment, newest within each kind.\nexport async function listPersonas(kind?: string): Promise {\n const tid = currentTenantId();\n const params: any[] = [tid];\n let where = \"WHERE tenant_id = ?\";\n if (kind && PERSONA_KINDS.has(kind)) { where += \" AND kind = ?\"; params.push(kind); }\n const r = await sqlite.execute(\n `SELECT * FROM marketing_personas ${where}\n ORDER BY CASE kind WHEN 'icp' THEN 0 WHEN 'persona' THEN 1 WHEN 'segment' THEN 2 ELSE 3 END,\n updated_at DESC, name COLLATE NOCASE ASC`,\n params,\n );\n return (r.rows || []).map((row: any[]) => hydratePersona(rowToObj(r.columns, row as any[])));\n}\n\nexport async function getPersona(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"SELECT * FROM marketing_personas WHERE id = ? AND tenant_id = ?\", [id, tid]);\n if (!r.rows || r.rows.length === 0) return null;\n return hydratePersona(rowToObj(r.columns, r.rows[0] as any[]));\n}\n\nexport async function createPersona(data: Record): Promise {\n const id = crypto.randomUUID();\n const now = new Date().toISOString();\n const kind = PERSONA_KINDS.has(data.kind) ? data.kind : \"persona\";\n await sqlite.execute(\n `INSERT INTO marketing_personas (id, name, kind, description, attributes, source, created_at, updated_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?)`,\n [\n id, data.name ?? null, kind, data.description ?? null,\n serializeAttributes(data.attributes),\n data.source === \"enrichment\" ? \"enrichment\" : \"manual\",\n now, now, currentTenantId(),\n ],\n );\n return getPersona(id);\n}\n\nexport async function updatePersona(id: string, data: Record): Promise {\n const tid = currentTenantId();\n const existing = await sqlite.execute(\"SELECT * FROM marketing_personas WHERE id = ? AND tenant_id = ?\", [id, tid]);\n if (!existing.rows || existing.rows.length === 0) return null;\n const cur = rowToObj(existing.columns, existing.rows[0] as any[]);\n const merged = {\n name: data.name ?? cur.name,\n kind: PERSONA_KINDS.has(data.kind) ? data.kind : cur.kind,\n description: data.description ?? cur.description,\n attributes: data.attributes !== undefined ? serializeAttributes(data.attributes) : cur.attributes,\n };\n await sqlite.execute(\n `UPDATE marketing_personas SET name=?, kind=?, description=?, attributes=?, updated_at=? WHERE id=? AND tenant_id=?`,\n [merged.name, merged.kind, merged.description, merged.attributes, new Date().toISOString(), id, tid],\n );\n return getPersona(id);\n}\n\nexport async function deletePersona(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"DELETE FROM marketing_personas WHERE id = ? AND tenant_id = ?\", [id, tid]);\n return Number((r as any)?.rowsAffected ?? 0) > 0;\n}\n\n// Import ICP / persona / segment rows from the company-enrichment output (company profile).\n// NON-DESTRUCTIVE: it never deletes existing rows. It upserts one 'enrichment'-sourced row per\n// derived audience, matched on (kind, name) so re-running refreshes rather than duplicates;\n// manual rows and prior content are left untouched. The profile's `icp` field is free-form text\n// (\"ideal customer profile, segments, personas\"); we capture it as the canonical ICP row and\n// also lift `markets`/`competitors` into segment context so the library has real, sourced content.\nexport async function importPersonasFromEnrichment(): Promise<{ imported: number; personas: any[] }> {\n let profile: any = {};\n try {\n // Prefer the live-synthesized profile; fall back to the stored one. Import lazily so this\n // module doesn't hard-depend on the LLM-heavy enrichment path at load time.\n const mod = await import(\"./company-enrichment.ts\").catch(() => null as any);\n if (mod?.enrichCompanyProfile) profile = await mod.enrichCompanyProfile().catch(() => ({}));\n } catch { /* fall through to stored profile */ }\n if (!profile || Object.keys(profile).length === 0) {\n profile = await getCompanyProfile().catch(() => ({}));\n }\n\n const candidates: Array<{ name: string; kind: string; description: string; attributes: Record }> = [];\n const icpText = String(profile?.icp ?? \"\").trim();\n if (icpText) {\n candidates.push({\n name: profile?.name ? `${profile.name} ICP` : \"Ideal Customer Profile\",\n kind: \"icp\",\n description: icpText,\n attributes: {\n product: profile?.product ?? null,\n value_proposition: profile?.value_proposition ?? null,\n },\n });\n }\n const markets = String(profile?.markets ?? \"\").trim();\n if (markets) {\n candidates.push({\n name: \"Target markets\",\n kind: \"segment\",\n description: markets,\n attributes: { source_field: \"markets\" },\n });\n }\n const competitors = String(profile?.competitors ?? \"\").trim();\n if (competitors) {\n candidates.push({\n name: \"Competitive landscape\",\n kind: \"segment\",\n description: competitors,\n attributes: { source_field: \"competitors\" },\n });\n }\n\n const tid = currentTenantId();\n const out: any[] = [];\n for (const c of candidates) {\n // Match on (kind, name) within tenant to upsert non-destructively.\n const existing = await sqlite.execute(\n \"SELECT id FROM marketing_personas WHERE tenant_id = ? AND kind = ? AND name = ? LIMIT 1\",\n [tid, c.kind, c.name],\n );\n const now = new Date().toISOString();\n if (existing.rows && existing.rows.length > 0) {\n const id = String((existing.rows[0] as any[])[0]);\n await sqlite.execute(\n `UPDATE marketing_personas SET description=?, attributes=?, source='enrichment', updated_at=? WHERE id=? AND tenant_id=?`,\n [c.description, serializeAttributes(c.attributes), now, id, tid],\n );\n out.push(await getPersona(id));\n } else {\n const id = crypto.randomUUID();\n await sqlite.execute(\n `INSERT INTO marketing_personas (id, name, kind, description, attributes, source, created_at, updated_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?)`,\n [id, c.name, c.kind, c.description, serializeAttributes(c.attributes), \"enrichment\", now, now, tid],\n );\n out.push(await getPersona(id));\n }\n }\n return { imported: out.length, personas: out };\n}\n\n// ─── UTM LINKS (campaign-tagged URL builder) ─────────────────────────────────\n// Compose base_url + utm_* params into a single canonical full_url. Existing query string on the\n// base is preserved; utm_* values are appended/overwritten via URLSearchParams so the result is a\n// valid, encoded URL. Falls back to a manual join when base isn't a parseable absolute URL.\nfunction buildFullUrl(base: string, params: Record): string {\n const baseStr = String(base ?? \"\").trim();\n const pairs: Array<[string, string]> = [];\n for (const key of [\"utm_source\", \"utm_medium\", \"utm_campaign\", \"utm_term\", \"utm_content\"]) {\n const v = (params[key] ?? \"\").toString().trim();\n if (v) pairs.push([key, v]);\n }\n if (!baseStr) return \"\";\n try {\n const u = new URL(baseStr);\n for (const [k, v] of pairs) u.searchParams.set(k, v);\n return u.toString();\n } catch {\n // Not an absolute URL — append manually, respecting any existing query string.\n if (pairs.length === 0) return baseStr;\n const qs = pairs.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join(\"&\");\n return baseStr + (baseStr.includes(\"?\") ? \"&\" : \"?\") + qs;\n }\n}\n\nexport async function listUtmLinks(): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\n \"SELECT * FROM utm_links WHERE tenant_id = ? ORDER BY created_at DESC\",\n [tid],\n );\n return (r.rows || []).map((row: any[]) => rowToObj(r.columns, row as any[]));\n}\n\nexport async function getUtmLink(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"SELECT * FROM utm_links WHERE id = ? AND tenant_id = ?\", [id, tid]);\n if (!r.rows || r.rows.length === 0) return null;\n return rowToObj(r.columns, r.rows[0] as any[]);\n}\n\nexport async function createUtmLink(data: Record): Promise {\n const id = crypto.randomUUID();\n const now = new Date().toISOString();\n const full_url = buildFullUrl(data.base_url, {\n utm_source: data.utm_source,\n utm_medium: data.utm_medium,\n utm_campaign: data.utm_campaign,\n utm_term: data.utm_term,\n utm_content: data.utm_content,\n });\n await sqlite.execute(\n `INSERT INTO utm_links (id, name, base_url, utm_source, utm_medium, utm_campaign, utm_term, utm_content, full_url, created_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?,?,?)`,\n [\n id, data.name ?? null, data.base_url ?? null,\n data.utm_source ?? null, data.utm_medium ?? null, data.utm_campaign ?? null,\n data.utm_term ?? null, data.utm_content ?? null, full_url, now, currentTenantId(),\n ],\n );\n return getUtmLink(id);\n}\n\nexport async function deleteUtmLink(id: string): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"DELETE FROM utm_links WHERE id = ? AND tenant_id = ?\", [id, tid]);\n return Number((r as any)?.rowsAffected ?? 0) > 0;\n}\n\n// ─── BRAND KIT (one row per tenant — upsert) ─────────────────────────────────\nfunction hydrateBrandKit(k: Record): Record {\n // SQL column is brand_values (\"values\" is a reserved word); expose it to the API as `values`.\n const { brand_values, ...rest } = k;\n return { ...rest, values: brand_values ?? null, palette: toJsonObject(k.palette) };\n}\n\n// Return the single brand_kit row for the tenant, or an honest empty shell when none saved yet.\nexport async function getBrandKit(): Promise {\n const tid = currentTenantId();\n const r = await sqlite.execute(\"SELECT * FROM brand_kit WHERE tenant_id = ? LIMIT 1\", [tid]);\n if (!r.rows || r.rows.length === 0) {\n return {\n id: null, voice: null, tone: null, values: null, dos: null, donts: null,\n boilerplate: null, palette: {}, logo_url: null, updated_at: null, tenant_id: tid,\n };\n }\n return hydrateBrandKit(rowToObj(r.columns, r.rows[0] as any[]));\n}\n\n// Upsert the single brand_kit row for the tenant. Partial patches merge with the existing row so\n// editing one field never wipes the others. palette is stored as JSON text.\nexport async function saveBrandKit(patch: Record): Promise {\n const tid = currentTenantId();\n const now = new Date().toISOString();\n const existing = await sqlite.execute(\"SELECT * FROM brand_kit WHERE tenant_id = ? LIMIT 1\", [tid]);\n const hasRow = existing.rows && existing.rows.length > 0;\n const cur = hasRow ? rowToObj(existing.columns, existing.rows[0] as any[]) : {};\n\n const merged = {\n voice: patch.voice ?? cur.voice ?? null,\n tone: patch.tone ?? cur.tone ?? null,\n values: patch.values ?? cur.brand_values ?? null,\n dos: patch.dos ?? cur.dos ?? null,\n donts: patch.donts ?? cur.donts ?? null,\n boilerplate: patch.boilerplate ?? cur.boilerplate ?? null,\n palette: patch.palette !== undefined\n ? JSON.stringify(toJsonObject(patch.palette))\n : (cur.palette ?? JSON.stringify({})),\n logo_url: patch.logo_url ?? cur.logo_url ?? null,\n };\n\n if (hasRow) {\n await sqlite.execute(\n `UPDATE brand_kit SET voice=?, tone=?, brand_values=?, dos=?, donts=?, boilerplate=?, palette=?, logo_url=?, updated_at=? WHERE id=? AND tenant_id=?`,\n [merged.voice, merged.tone, merged.values, merged.dos, merged.donts, merged.boilerplate,\n merged.palette, merged.logo_url, now, String(cur.id), tid],\n );\n } else {\n await sqlite.execute(\n `INSERT INTO brand_kit (id, voice, tone, brand_values, dos, donts, boilerplate, palette, logo_url, updated_at, tenant_id)\n VALUES (?,?,?,?,?,?,?,?,?,?,?)`,\n [crypto.randomUUID(), merged.voice, merged.tone, merged.values, merged.dos, merged.donts,\n merged.boilerplate, merged.palette, merged.logo_url, now, tid],\n );\n }\n return getBrandKit();\n}\n\n// ─── MARKETING → SALES HANDOFF (Wave 2) ──────────────────────────────────────\n// The bridge between the Marketing surface and the CRM pipeline: surface the leads\n// that are qualified-but-not-yet-a-deal, and let a user promote one into a real deal.\n// Both functions are TENANT-SCOPED (normal authed session): every read filters\n// tenant_id and every write carries currentTenantId() (createDeal / setLeadStatus do\n// this internally). These are NOT the public-submit path — they require a session.\n\nfunction normEmail(email: string): string {\n return String(email || \"\").trim().toLowerCase();\n}\n\n// listMqlReady — qualified leads (lead_status grade A|B) that do NOT yet have a deal.\n// \"Qualified\" is taken from lead_status.grade (A|B) within the tenant; we LEFT JOIN\n// deals BY EMAIL (matching either deals.lead_email or deals.contact_email, case-insensitive)\n// and keep only the leads with no matching deal. Each row is enriched from the funnel\n// intelligence (getLeadScores: name / company / stage / mql_score) when that email is\n// covered, so the handoff table shows a real prospect — not just an address. Tenant-scoped.\nexport async function listMqlReady(): Promise {\n const tid = currentTenantId();\n\n // Graded A|B leads for this tenant that have NO deal keyed to their email.\n const r = await sqlite.execute(\n `SELECT ls.lead_email AS lead_email, ls.grade AS grade, ls.owner AS owner,\n ls.status AS status, ls.updated_at AS status_updated_at\n FROM lead_status ls\n WHERE ls.tenant_id = ?\n AND ls.grade IN ('A','B')\n AND NOT EXISTS (\n SELECT 1 FROM deals d\n WHERE d.tenant_id = ls.tenant_id\n AND (lower(d.lead_email) = lower(ls.lead_email)\n OR lower(d.contact_email) = lower(ls.lead_email))\n )\n ORDER BY CASE ls.grade WHEN 'A' THEN 0 WHEN 'B' THEN 1 ELSE 2 END,\n ls.updated_at DESC`,\n [tid],\n );\n const rows = (r.rows || []).map((row: any[]) => rowToObj(r.columns, row as any[]));\n if (rows.length === 0) return [];\n\n // Enrich with name/company/stage/score from the funnel intelligence where available.\n let scoreByEmail = new Map();\n try {\n const scores = await getLeadScores().catch(() => []);\n for (const s of (scores as any[]) || []) scoreByEmail.set(normEmail(s.email), s);\n } catch { /* intelligence unavailable → grade-only rows are still honest */ }\n\n return rows.map((row: Record) => {\n const s = scoreByEmail.get(normEmail(row.lead_email)) || {};\n return {\n lead_email: row.lead_email,\n grade: row.grade,\n owner: row.owner ?? null,\n status: row.status ?? null,\n status_updated_at: row.status_updated_at ?? null,\n name: s.name ?? null,\n company: s.company ?? null,\n lead_stage: s.stage ?? null, // cold | MQL | SQL (intelligence funnel stage)\n mql_score: s.mql_score ?? null,\n last_touch_at: s.last_touch_at ?? null,\n };\n });\n}\n\n// promoteLeadToDeal — turn a qualified lead into a CRM pipeline deal. Tenant-scoped.\n// (1) resolve the lead's identity: prefer an existing contact (contacts, by email),\n// fall back to the funnel intelligence LeadScore, then to the raw email; (2) create a\n// deal via deals.ts createDeal (which sets tenant_id + seeds the pipeline from \"lead\"/\n// \"qualified\"); (3) mark lead_status.status = \"qualified\" via leads_crm.ts setLeadStatus.\n// Idempotent-ish: if a deal already exists for this email we return it rather than duplicating.\nexport async function promoteLeadToDeal(leadEmail: string): Promise<{ ok: boolean; deal: any | null; reason?: string }> {\n const tid = currentTenantId();\n const email = normEmail(leadEmail);\n if (!email) return { ok: false, deal: null, reason: \"missing lead_email\" };\n\n // Guard against duplicate promotion: a deal already keyed to this email.\n const dup = await sqlite.execute(\n `SELECT * FROM deals\n WHERE tenant_id = ?\n AND (lower(lead_email) = ? OR lower(contact_email) = ?)\n LIMIT 1`,\n [tid, email, email],\n ).catch(() => null);\n if (dup?.rows && dup.rows.length > 0) {\n return { ok: true, deal: rowToObj(dup.columns, dup.rows[0] as any[]), reason: \"already_promoted\" };\n }\n\n // Resolve name / company: existing contact first, then intelligence, then the email itself.\n let name: string | null = null;\n let company: string | null = null;\n let contactId: string | null = null;\n\n const c = await sqlite.execute(\n \"SELECT id, first_name, last_name FROM contacts WHERE lower(email) = ? AND tenant_id = ? LIMIT 1\",\n [email, tid],\n ).catch(() => null);\n if (c?.rows && c.rows.length > 0) {\n const co = rowToObj(c.columns, c.rows[0] as any[]);\n contactId = String(co.id);\n const full = [co.first_name, co.last_name].filter(Boolean).join(\" \").trim();\n if (full) name = full;\n }\n\n if (!name || !company) {\n try {\n const scores = await getLeadScores().catch(() => []);\n const match = (scores as any[]).find((s) => normEmail(s.email) === email);\n if (match) {\n name = name || match.name || null;\n company = company || match.company || null;\n }\n } catch { /* intelligence unavailable → fall back to the bare email */ }\n }\n\n const label = company || name || email;\n const deal = await createDeal({\n title: `${label} — opportunity`,\n company,\n contact_name: name,\n contact_email: email,\n lead_email: email,\n primary_contact_id: contactId,\n stage: \"qualified\",\n source: \"marketing_handoff\",\n });\n\n // Reflect the promotion on the lead funnel: this lead is now qualified (in the pipeline).\n await setLeadStatus(email, \"qualified\").catch(() => {});\n\n return { ok: true, deal };\n}\n","createdAt",["D",1780467935913],"branchVersion","branchId","ecb58646-56c9-11f1-abd8-ee650bb23af1","id","ecb4ccf6-56c9-11f1-abd8-ee650bb23af1","aihivecommand",["D",1779556068488],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","AIHive Command Center","imageUrl","e8c17657-6210-4c45-bd2b-dbcf2e020293","pinnedFileId","32167c2c-56ca-11f1-955a-ee650bb23af1","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019e4de5-f6b1-7488-a017-a3a028bc2ba8","tursoName","ecb4ccf656c911f1abd8ee650bb23af1","tursoHostname","ecb4ccf656c911f1abd8ee650bb23af1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789503703835],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_101":100,"_108":104},"org",{"_101":100,"_102":100,"_103":104,"_18":56,"_105":106,"_107":25},"branch",{"_13":90,"_32":91,"_44":43,"_92":45,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":46,"_99":100},"isOwned",1111,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","vlduy123","handle","displayName","avatar","https://avatars.githubusercontent.com/u/208025931?v=4","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_44":45,"_32":46,"_39":1631,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":1632,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":1633,"_85":1634,"_87":1635,"_89":25},"tree",[490,557,575,604,605,606,607,608,609,610,611,612,613,614,615,616,617,618,619,620,621,622,623,624,625,626,627,628,629,630,631,632,633,634,635,636,637,638,639,640,641],"files",[490,491,492,493,494,495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510,511,512,513,514,515,516,517,518,519,520,521,522,523,524,525,526,527,528,529,530,531,532,533,534,535,536,537,538,539,540,541,542,543,544,545,546,547,548,549,550,551,552,553,554,555,556,557,558,559,560,561,562,563,564,565,566,567,568,569,570,571,572,573,574,575,576,577,578,579,580,581,582,583,584,585,586,587,588,589,590,591,592,593,594,595,596,597,598,599,600,601,602,603,604,605,606,607,608,609,610,611,612,613,614,615,616,617,618,619,620,621,622,623,624,625,626,627,628,629,630,631,632,633,634,635,636,637,638,639,640,641],"counts",{"_480":64,"_481":430,"_482":64,"_483":484,"_485":486},"contents",[131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":475,"_32":476,"_30":477,"_175":-5,"_42":43,"_41":266,"_177":60,"_39":478,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_27":479},{"_44":469,"_32":470,"_30":471,"_175":-5,"_42":43,"_41":472,"_177":60,"_39":473,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_27":474},{"_44":462,"_32":463,"_30":464,"_175":-5,"_42":43,"_41":465,"_177":60,"_39":466,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_27":468},{"_44":455,"_32":456,"_30":457,"_175":-5,"_42":43,"_41":458,"_177":25,"_39":459,"_13":204,"_34":35,"_36":460,"_24":25,"_181":-5,"_27":461},{"_44":448,"_32":449,"_30":450,"_175":-5,"_42":43,"_41":451,"_177":60,"_39":452,"_13":266,"_34":35,"_36":453,"_24":25,"_181":-5,"_27":454},{"_44":440,"_32":441,"_30":442,"_175":-5,"_42":43,"_41":443,"_177":25,"_39":444,"_13":445,"_34":35,"_36":446,"_24":25,"_181":-5,"_27":447},{"_44":433,"_32":434,"_30":435,"_175":-5,"_42":43,"_41":436,"_177":25,"_39":437,"_13":195,"_34":35,"_36":438,"_24":25,"_181":-5,"_27":439},{"_44":425,"_32":426,"_30":427,"_175":-5,"_42":43,"_41":428,"_177":60,"_39":429,"_13":430,"_34":35,"_36":431,"_24":25,"_181":-5,"_27":432},{"_44":417,"_32":418,"_30":419,"_175":-5,"_42":43,"_41":420,"_177":60,"_39":421,"_13":422,"_34":35,"_36":423,"_24":25,"_181":-5,"_27":424},{"_44":409,"_32":410,"_30":411,"_175":-5,"_42":43,"_41":412,"_177":60,"_39":413,"_13":414,"_34":35,"_36":415,"_24":25,"_181":-5,"_27":416},{"_44":402,"_32":403,"_30":404,"_175":-5,"_42":43,"_41":405,"_177":60,"_39":406,"_13":242,"_34":35,"_36":407,"_24":25,"_181":-5,"_27":408},{"_44":394,"_32":395,"_30":396,"_175":-5,"_42":43,"_41":397,"_177":60,"_39":398,"_13":399,"_34":35,"_36":400,"_24":25,"_181":-5,"_27":401},{"_44":387,"_32":388,"_30":389,"_175":-5,"_42":43,"_41":390,"_177":60,"_39":391,"_13":204,"_34":35,"_36":392,"_24":25,"_181":-5,"_27":393},{"_44":380,"_32":381,"_30":382,"_175":-5,"_42":43,"_41":383,"_177":60,"_39":384,"_13":64,"_34":35,"_36":385,"_24":25,"_181":-5,"_27":386},{"_44":373,"_32":374,"_30":375,"_175":-5,"_42":43,"_41":376,"_177":60,"_39":377,"_13":303,"_34":35,"_36":378,"_24":25,"_181":-5,"_27":379},{"_44":366,"_32":367,"_30":368,"_175":-5,"_42":43,"_41":369,"_177":60,"_39":370,"_13":204,"_34":35,"_36":371,"_24":25,"_181":-5,"_27":372},{"_44":358,"_32":359,"_30":360,"_175":-5,"_42":43,"_41":361,"_177":25,"_39":362,"_13":363,"_34":35,"_36":364,"_24":25,"_181":-5,"_27":365},{"_44":350,"_32":351,"_30":352,"_175":-5,"_42":43,"_41":353,"_177":25,"_39":354,"_13":355,"_34":35,"_36":356,"_24":25,"_181":-5,"_27":357},{"_44":343,"_32":344,"_30":345,"_175":-5,"_42":43,"_41":346,"_177":60,"_39":347,"_13":311,"_34":35,"_36":348,"_24":25,"_181":-5,"_27":349},{"_44":336,"_32":337,"_30":338,"_175":-5,"_42":43,"_41":339,"_177":25,"_39":340,"_13":64,"_34":35,"_36":341,"_24":25,"_181":-5,"_27":342},{"_44":329,"_32":330,"_30":331,"_175":-5,"_42":43,"_41":332,"_177":60,"_39":333,"_13":303,"_34":35,"_36":334,"_24":25,"_181":-5,"_27":335},{"_44":321,"_32":322,"_30":323,"_175":-5,"_42":43,"_41":324,"_177":25,"_39":325,"_13":326,"_34":35,"_36":327,"_24":25,"_181":-5,"_27":328},{"_44":314,"_32":315,"_30":316,"_175":-5,"_42":43,"_41":317,"_177":60,"_39":318,"_13":266,"_34":35,"_36":319,"_24":25,"_181":-5,"_27":320},{"_44":306,"_32":307,"_30":308,"_175":-5,"_42":43,"_41":309,"_177":60,"_39":310,"_13":311,"_34":35,"_36":312,"_24":25,"_181":-5,"_27":313},{"_44":298,"_32":299,"_30":300,"_175":-5,"_42":43,"_41":301,"_177":60,"_39":302,"_13":303,"_34":35,"_36":304,"_24":25,"_181":-5,"_27":305},{"_44":290,"_32":291,"_30":292,"_175":-5,"_42":43,"_41":293,"_177":25,"_39":294,"_13":295,"_34":35,"_36":296,"_24":25,"_181":-5,"_27":297},{"_44":283,"_32":284,"_30":285,"_175":-5,"_42":43,"_41":286,"_177":60,"_39":287,"_13":266,"_34":35,"_36":288,"_24":25,"_181":-5,"_27":289},{"_44":276,"_32":277,"_30":278,"_175":-5,"_42":43,"_41":279,"_177":60,"_39":280,"_13":220,"_34":35,"_36":281,"_24":25,"_181":-5,"_27":282},{"_44":269,"_32":270,"_30":271,"_175":-5,"_42":43,"_41":272,"_177":60,"_39":273,"_13":204,"_34":35,"_36":274,"_24":25,"_181":-5,"_27":275},{"_44":261,"_32":262,"_30":263,"_175":-5,"_42":43,"_41":264,"_177":60,"_39":265,"_13":266,"_34":35,"_36":267,"_24":25,"_181":-5,"_27":268},{"_44":253,"_32":254,"_30":255,"_175":-5,"_42":43,"_41":256,"_177":60,"_39":257,"_13":258,"_34":35,"_36":259,"_24":25,"_181":-5,"_27":260},{"_44":245,"_32":246,"_30":247,"_175":-5,"_42":43,"_41":248,"_177":60,"_39":249,"_13":250,"_34":35,"_36":251,"_24":25,"_181":-5,"_27":252},{"_44":237,"_32":238,"_30":239,"_175":-5,"_42":43,"_41":240,"_177":60,"_39":241,"_13":242,"_34":35,"_36":243,"_24":25,"_181":-5,"_27":244},{"_44":230,"_32":231,"_30":232,"_175":-5,"_42":43,"_41":233,"_177":60,"_39":234,"_13":64,"_34":35,"_36":235,"_24":25,"_181":-5,"_27":236},{"_44":223,"_32":224,"_30":225,"_175":-5,"_42":43,"_41":226,"_177":60,"_39":227,"_13":64,"_34":35,"_36":228,"_24":25,"_181":-5,"_27":229},{"_44":215,"_32":216,"_30":217,"_175":-5,"_42":43,"_41":218,"_177":60,"_39":219,"_13":220,"_34":35,"_36":221,"_24":25,"_181":-5,"_27":222},{"_44":207,"_32":208,"_30":209,"_175":-5,"_42":43,"_41":210,"_177":60,"_39":211,"_13":212,"_34":35,"_36":213,"_24":25,"_181":-5,"_27":214},{"_44":199,"_32":200,"_30":201,"_175":-5,"_42":43,"_41":202,"_177":60,"_39":203,"_13":204,"_34":35,"_36":205,"_24":25,"_181":-5,"_27":206},{"_44":191,"_32":192,"_30":58,"_175":-5,"_42":43,"_41":193,"_177":25,"_39":194,"_13":195,"_34":196,"_36":197,"_24":25,"_181":-5,"_27":198},{"_44":183,"_32":184,"_30":185,"_175":-5,"_42":43,"_41":186,"_177":25,"_39":187,"_13":188,"_34":35,"_36":189,"_24":25,"_181":-5,"_27":190},{"_44":172,"_32":173,"_30":174,"_175":-5,"_42":43,"_41":176,"_177":60,"_39":178,"_13":179,"_34":35,"_36":180,"_24":25,"_181":-5,"_27":182},"026e63e8-5d7a-11f1-a7f5-1607ee4eb77e","types.ts","151549be-56ca-11f1-bc41-ee650bb23af1","parentId",699,"latest",["D",1780291403301],16,"export interface Integration {\n id: string;\n name: string; // 'ahrefs'|'ga4'|'gsc'|'linkedin'|'outlook'|'wordpress'|'youtube'|'producthunt'\n api_key?: string;\n api_secret?: string;\n access_token?: string;\n refresh_token?: string;\n extra_config?: string; // JSON string\n connected_at?: string;\n updated_at?: string;\n}\n\nexport interface LLMConfig {\n id: string;\n // QA fix: gemini was already routed in callLLM but missing from the union, causing TS noise.\n provider: 'anthropic' | 'openai' | 'gemini' | 'custom';\n api_key: string;\n endpoint?: string;\n model: string;\n updated_at?: string;\n // Per-provider key presence flags (computed from the 4 api_key_ columns) —\n // used by Settings UI to render \"(saved)\" pills without leaking the actual key.\n has_key?: { anthropic: boolean; openai: boolean; gemini: boolean; custom: boolean };\n}\n\nexport interface Agent {\n id: string;\n name: string;\n workspace: 'marketing' | 'sales';\n description: string;\n system_prompt: string;\n tools: string; // JSON array string\n model?: string;\n enabled: number; // 0 or 1\n created_at: string;\n updated_at: string;\n created_by: 'user' | 'ai';\n // B2: budget cap (USD/month) + running spend, joined from agent_budgets\n monthly_cap?: number;\n current_spend?: number;\n}\n\nexport interface Conversation {\n id: string;\n agent_id?: string;\n workspace: string;\n messages: string; // JSON array string\n created_at: string;\n updated_at: string;\n}\n\nexport interface Task {\n id: string;\n agent_id?: string;\n workspace: string;\n title: string;\n status: 'pending' | 'running' | 'done' | 'failed';\n input?: string;\n output?: string;\n created_at: string;\n completed_at?: string;\n}\n\nexport interface ChatMessage {\n role: 'user' | 'assistant' | 'system' | 'tool';\n content: string;\n timestamp?: string;\n // Tool-use fields (OpenAI-style) carried at runtime by chat.ts / llm.ts.\n tool_calls?: any[];\n tool_call_id?: string;\n reasoning_content?: string;\n // Part 14.2: structured execution trace (round/tool/action/message steps) shown in the UI.\n trace?: Array<{ t: string; role?: string; name?: string; preview?: string; args_preview?: string; result_preview?: string; ok?: boolean; ms?: number; n?: number; ts?: string }>;\n}\n","label",[173],"279f0c3a-5f0f-11f1-9c3f-1607ee4eb77e","router.ts","30479b74-56ca-11f1-a296-ee650bb23af1",995,["D",1780465411894],125,"import { sqlite, initDB, DEFAULT_AGENT_SEEDS, currentRole, currentTenantId, currentCtx } from \"./db.ts\";\nimport { registerUser, loginUser, getMe, upsertOAuthUser, bootstrapOwner } from \"./api/auth.ts\";\nimport { resolveSession, sessionSetCookie, sessionClearCookie } from \"./api/session.ts\";\nimport { newOAuthState, CLEAR_OAUTH_STATE, redirectWithCookie, oauthStateValid, identityLoginStart, identityLoginCallback } from \"./api/oauth_login.ts\";\nimport { listAgents, createAgent, updateAgent, deleteAgent } from \"./api/agents.ts\";\nimport { getLLMConfig, saveLLMConfig } from \"./api/llm.ts\";\nimport { handleChat, handleChatStream, listConversations, getConversationById, deleteConversation } from \"./api/chat.ts\";\nimport { handleIntegrationProxy, getCredentials, GOOGLE_SERVICES, MICROSOFT_SCOPES, getIntegrationSchema, listDescriptorNames } from \"./api/integrations.ts\";\nimport { getAppJS } from \"./frontend_js.ts\";\nimport { getUIJS } from \"./frontend_ui.ts\";\nimport { getChartsJS } from \"./frontend_charts.ts\";\nimport { getRenderersJS } from \"./frontend_renderers.ts\";\nimport { getRenderers2JS } from \"./frontend_renderers2.ts\";\nimport { getCRMJS } from \"./frontend_crm.ts\";\nimport { getCRM2JS } from \"./frontend_crm2.ts\";\nimport { getMarketing2JS } from \"./frontend_marketing2.ts\";\nimport { getPagesJS } from \"./frontend_pages.ts\";\nimport { getCommandJS } from \"./frontend_command.ts\";\nimport { getIntelligenceJS } from \"./frontend_intelligence.ts\";\nimport { getSettingsJS } from \"./frontend_settings.ts\";\nimport { getWidgetsJS } from \"./frontend_widgets.ts\";\nimport { getObjectivesJS } from \"./frontend_objectives.ts\";\nimport { getCalendarJS } from \"./frontend_calendar.ts\";\nimport { getExperimentsJS } from \"./frontend_experiments.ts\";\nimport { getFunnelSummary, getCorrelations, getRecommendations, getLeadScores, getAIOKpis, getIntelligenceFeed } from \"./api/intelligence.ts\";\nimport { listSignals, recordSignal, actionSignal, getHotLeads, getHotLeadsCount } from \"./api/signals.ts\";\nimport { listObjectives, createObjective, updateObjective, deleteObjective, createKeyResult, updateKeyResult, getOKRDashboard, syncObjectivesFromFunnel } from \"./api/okrs.ts\";\nimport { getNSM, setNSM, recordNSMValue, getNSMProgress } from \"./api/nsm.ts\";\nimport { listCohorts, createCohort, deleteCohort, getCohortSummary, getEngagementVelocity, getAttributionSummary, recordConversion, getRetention, getRevenueModel } from \"./api/aio.ts\";\nimport { getLatestDigest, generateDigest, getDigestHistory } from \"./api/digest.ts\";\nimport { listExperiments, createExperiment, updateExperiment, deleteExperiment, runExperiment, completeExperiment, getExperimentStats, suggestICE } from \"./api/experiments.ts\";\nimport { getUnifiedCalendar, getCalendarSummary, createCalendarEntry, updateCalendarEntry, deleteCalendarEntry } from \"./api/calendar_unified.ts\";\nimport { getGraphify } from \"./api/graphify.ts\";\nimport { listTasks, createTask, updateTask, deleteTask, listIceRankedTasks, generateTasksFromSource, runTask } from \"./api/tasks.ts\";\nimport { listDeals, getDeal, createDeal, updateDeal, deleteDeal, syncDealsFromLeads, listCandidates, importDeals } from \"./api/deals.ts\";\nimport { listKnowledgeFiles, getKnowledgeFile, createKnowledgeFile, updateKnowledgeFile, deleteKnowledgeFile, summarizeKnowledgeFile, buildKnowledgeGraph, AI_FEATURES } from \"./api/knowledge.ts\";\nimport { getCompanyProfile, setCompanyProfile, getBrandContext, setBrandContext } from \"./api/company.ts\";\nimport { enrichCompanyProfile } from \"./api/company-enrichment.ts\";\nimport { listMemory, addMemory, updateMemory, deleteMemory } from \"./api/memory.ts\";\nimport { listSkills, getSkill, setSkillState, createCustomSkill } from \"./api/skills.ts\";\nimport { getSkillsJS } from \"./frontend_skills.ts\";\nimport { getWorldJS } from \"./frontend_world.ts\";\nimport { getWorldSceneJS } from \"./frontend_world_scene.ts\";\nimport { getWorldOfficeJS } from \"./frontend_world_office.ts\";\nimport { getWorldAgentsJS } from \"./frontend_world_agents.ts\";\nimport { getWorldUIJS } from \"./frontend_world_ui.ts\";\nimport { getWorldDashJS } from \"./frontend_world_dash.ts\";\nimport { getCampaignsJS } from \"./frontend_campaigns.ts\";\nimport { getTasksJS } from \"./frontend_tasks.ts\";\nimport { getKnowledgeGraphJS } from \"./frontend_knowledge_graph.ts\";\nimport { getApprovalsJS } from \"./frontend_approvals.ts\";\nimport { getMethodConfig, saveMethodConfig, getMethodsMetadata } from \"./api/method_config.ts\";\nimport { listActions, enqueueAction, getAction, approveAction, rejectAction } from \"./api/actions.ts\";\nimport { processPendingRuns } from \"./cron.ts\";\nimport { getExecutedWorkCounts } from \"./api/propagate.ts\";\nimport { listCampaigns, getCampaign, getCampaignAgents, createCampaign, deleteCampaign, listCampaignRuns, orchestrateCampaignRun, updateCampaign, setCampaignTrigger } from \"./api/campaigns.ts\";\nimport { getWorldActivity, getWorldBoard, getWorldProject } from \"./api/world.ts\";\nimport { getPlatformJS } from \"./frontend_platform.ts\";\nimport { handlePlatformRoutes } from \"./api/platform.ts\";\nimport { isCrmPath, handleCrmRoutes } from \"./api/crm_routes.ts\";\nimport { isMarketingPath, handleMarketingRoutes } from \"./api/marketing_routes.ts\";\n\nconst corsHeaders = {\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, PUT, DELETE, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n};\n\n// App version for the data-free health probe. Prefer the val.town deploy id (DENO_DEPLOYMENT_ID\n// is set by the runtime per deploy); fall back to a hardcoded release tag when running locally.\nconst APP_VERSION = (() => {\n try { return Deno.env.get(\"DENO_DEPLOYMENT_ID\") || \"p3-s3\"; } catch { return \"p3-s3\"; }\n})();\n\nfunction json(data: unknown, status = 200): Response {\n return new Response(JSON.stringify(data), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n ...corsHeaders,\n },\n });\n}\n// JSON response that also carries a Set-Cookie header (session set/clear on auth endpoints).\nfunction jsonWithCookie(data: unknown, setCookie: string, status = 200): Response {\n const res = json(data, status);\n res.headers.append(\"Set-Cookie\", setCookie);\n return res;\n}\n// Best-effort client IP for per-IP rate limiting (val.town/Cloudflare forwarded headers).\nfunction clientIp(req: Request): string {\n return req.headers.get(\"x-forwarded-for\")?.split(\",\")[0].trim() || req.headers.get(\"cf-connecting-ip\") || \"\";\n}\n\n// Mask an integration row before returning it: NO endpoint may return secrets in cleartext\n// — only presence flags + a short masked hint.\nfunction maskIntegration(obj: any, googleConnected = false) {\n return {\n ...obj,\n connected: !!(obj.api_key || obj.access_token) ||\n (GOOGLE_SERVICES.includes(String(obj.name)) && googleConnected),\n has_api_key: !!obj.api_key,\n has_api_secret: !!obj.api_secret,\n has_access_token: !!obj.access_token,\n api_key: obj.api_key ? String(obj.api_key).slice(0, 4) + \"***\" : undefined,\n api_secret: obj.api_secret ? \"***\" : undefined,\n access_token: obj.access_token ? \"***\" : undefined,\n refresh_token: obj.refresh_token ? \"***\" : undefined,\n };\n}\n\n\nexport async function handleRequest(req: Request, url: URL): Promise {\n const { pathname } = url;\n const method = req.method;\n const tid = currentTenantId(); // tenant scope for every business query (stable within request)\n\n // CORS preflight\n if (method === \"OPTIONS\") {\n return new Response(null, { status: 204, headers: corsHeaders });\n }\n\n try {\n // GET /api/health — data-free liveness probe: { ok, version } (+ legacy status/timestamp).\n if (pathname === \"/api/health\" && method === \"GET\") {\n return json({ ok: true, version: APP_VERSION, status: \"ok\", timestamp: new Date().toISOString() });\n }\n\n // GET /api/health/auth - gated token verifier. Reaching this (past the main.ts gate) means the\n // APP_TOKEN is valid; the login screen uses it to confirm the password.\n if (pathname === \"/api/health/auth\" && method === \"GET\") {\n return json({ ok: true });\n }\n\n // --- Auth: email/password + session ----\n // Thin handlers — logic lives in api/auth.ts; the \"nexus_session\" cookie via api/session.ts.\n if (pathname === \"/api/auth/register\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const r = await registerUser({ email: body.email, password: body.password, name: body.name, honeypot: body.honeypot ?? body.company_url, turnstileToken: body.turnstileToken, ip: clientIp(req) });\n if (!r.ok) return json({ ok: false, error: r.error }, 400);\n return jsonWithCookie({ ok: true }, sessionSetCookie(r.ctxToken!));\n }\n if (pathname === \"/api/auth/login\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const r = await loginUser({ email: body.email, password: body.password, ip: clientIp(req) });\n if (!r.ok) return json({ ok: false, error: r.error }, 401);\n return jsonWithCookie({ ok: true }, sessionSetCookie(r.ctxToken!));\n }\n if (pathname === \"/api/auth/logout\" && method === \"POST\") {\n return jsonWithCookie({ ok: true }, sessionClearCookie());\n }\n if (pathname === \"/api/auth/me\" && method === \"GET\") {\n const ctx = await resolveSession(req);\n if (!ctx) return json({ ok: false, user: null }, 200);\n return json({ ok: true, ...(await getMe(ctx)) });\n }\n\n // GET /api/config - LLM runtime config + all app_config key/values\n if (pathname === \"/api/config\" && method === \"GET\") {\n const llmConfig = await getLLMConfig();\n const merged: Record = {\n provider: llmConfig.provider,\n model: llmConfig.model,\n has_key: (llmConfig as any).has_key,\n };\n try {\n const r = await sqlite.execute(\"SELECT key, value FROM app_config WHERE tenant_id = ?\", [tid]);\n for (const row of (r.rows || []) as any[]) {\n const k = String(row[0]);\n let v: any = row[1];\n if (typeof v === \"string\") { try { v = JSON.parse(v); } catch { /* keep raw string */ } }\n merged[k] = v;\n }\n } catch { /* app_config missing → just return LLM fields */ }\n return json(merged);\n }\n // POST /api/config - upsert arbitrary key/value into app_config (Settings toggles, ROI inputs…).\n if (pathname === \"/api/config\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const updated: Record = {};\n try {\n for (const [k, v] of Object.entries(body)) {\n if (k === \"provider\" || k === \"model\" || k === \"has_key\") continue;\n const value = typeof v === \"string\" ? v : JSON.stringify(v);\n await sqlite.execute(\n \"INSERT INTO app_config (key, value, tenant_id) VALUES (?, ?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value, tenant_id = excluded.tenant_id, updated_at = datetime('now')\",\n [k, value, tid],\n );\n updated[k] = v;\n }\n return json({ success: true, updated });\n } catch (e: any) {\n return json({ error: String(e?.message || e) }, 500);\n }\n }\n\n // --- Frontend JS module routes ----\n const jsModules: Record string> = {\n \"/api/app-js\": getAppJS,\n \"/api/app-ui\": getUIJS,\n \"/api/app-charts\": getChartsJS,\n \"/api/app-renderers\": getRenderersJS,\n \"/api/app-renderers2\": getRenderers2JS,\n \"/api/app-pages\": getPagesJS,\n \"/api/app-command\": getCommandJS,\n \"/api/app-intelligence\": getIntelligenceJS,\n \"/api/app-settings\": getSettingsJS,\n \"/api/app-widgets\": getWidgetsJS,\n \"/api/app-objectives\": getObjectivesJS,\n \"/api/app-calendar\": getCalendarJS,\n \"/api/app-experiments\": getExperimentsJS,\n \"/api/app-campaigns\": getCampaignsJS,\n \"/api/app-tasks\": getTasksJS,\n \"/api/app-knowledge-graph\": getKnowledgeGraphJS,\n \"/api/app-approvals\": getApprovalsJS,\n \"/api/app-crm\": getCRMJS,\n \"/api/app-crm2\": getCRM2JS,\n \"/api/app-marketing2\": getMarketing2JS,\n \"/api/app-skills\": getSkillsJS,\n \"/api/app-world\": getWorldJS,\n \"/api/app-world-scene\": getWorldSceneJS,\n \"/api/app-world-office\": getWorldOfficeJS,\n \"/api/app-world-agents\": getWorldAgentsJS,\n \"/api/app-world-ui\": getWorldUIJS,\n \"/api/app-world-dash\": getWorldDashJS,\n \"/api/app-platform\": getPlatformJS,\n };\n if (jsModules[pathname] && method === \"GET\") {\n return new Response(jsModules[pathname](), {\n headers: {\n \"Content-Type\": \"application/javascript\",\n \"Cache-Control\": \"no-cache, no-store, must-revalidate\",\n ...corsHeaders,\n },\n });\n }\n\n // --- Intelligence routes ----\n if (pathname === \"/api/intelligence/funnel-summary\" && method === \"GET\") {\n const force = url.searchParams.get(\"force\") === \"1\";\n const days = parseInt(url.searchParams.get(\"days\") ?? \"30\", 10);\n return json(await getFunnelSummary(force, days));\n }\n if (pathname === \"/api/intelligence/correlations\" && method === \"GET\") {\n const force = url.searchParams.get(\"force\") === \"1\";\n return json(await getCorrelations(force));\n }\n if (pathname === \"/api/intelligence/recommendations\" && method === \"GET\") {\n return json(await getRecommendations());\n }\n if (pathname === \"/api/intelligence/leads\" && method === \"GET\") {\n return json(await getLeadScores());\n }\n if (pathname === \"/api/intelligence/kpis\" && method === \"GET\") {\n return json(await getAIOKpis());\n }\n if (pathname === \"/api/intelligence/feed\" && method === \"GET\") {\n return json(await getIntelligenceFeed());\n }\n // Execution-aware metric: how much real work was completed (tasks/experiments).\n if (pathname === \"/api/intelligence/executed-work\" && method === \"GET\") {\n const days = parseInt(url.searchParams.get(\"days\") ?? \"30\", 10);\n return json(await getExecutedWorkCounts(days));\n }\n\n // --- Signals routes ----\n if (pathname === \"/api/signals\" && method === \"GET\") {\n const actioned = url.searchParams.get(\"actioned\");\n const lead_email = url.searchParams.get(\"lead_email\") ?? undefined;\n return json(await listSignals({ lead_email, actioned: actioned === \"true\" ? true : actioned === \"false\" ? false : undefined }));\n }\n if (pathname === \"/api/signals\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (!body.lead_email || !body.signal_type) {\n return json({ error: \"lead_email and signal_type are required\" }, 400);\n }\n return json(await recordSignal(body), 201);\n }\n const signalActionMatch = pathname.match(/^\\/api\\/signals\\/([^/]+)\\/action$/);\n if (signalActionMatch && method === \"PUT\") {\n const result = await actionSignal(signalActionMatch[1]);\n return result ? json(result) : json({ error: \"Signal not found\" }, 404);\n }\n if (pathname === \"/api/signals/hot-leads\" && method === \"GET\") {\n return json(await getHotLeads());\n }\n if (pathname === \"/api/signals/hot-leads/count\" && method === \"GET\") {\n return json({ count: await getHotLeadsCount() });\n }\n\n // --- OKR / Objectives routes ----\n if (pathname === \"/api/okrs\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n return json(await listObjectives({ workspace }));\n }\n if (pathname === \"/api/okrs\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createObjective(body), 201);\n }\n if (pathname === \"/api/okrs/dashboard\" && method === \"GET\") {\n return json(await getOKRDashboard());\n }\n // Explicit funnel→OKR sync — refreshes stored KR/objective progress on demand.\n if (pathname === \"/api/okrs/sync\" && method === \"POST\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n return json(await syncObjectivesFromFunnel({ workspace }));\n }\n const okrIdMatch = pathname.match(/^\\/api\\/okrs\\/([^/]+)$/);\n if (okrIdMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n return json(await updateObjective(okrIdMatch[1], body));\n }\n if (okrIdMatch && method === \"DELETE\") {\n const ok = await deleteObjective(okrIdMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n const okrKrMatch = pathname.match(/^\\/api\\/okrs\\/([^/]+)\\/key-results$/);\n if (okrKrMatch && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createKeyResult(okrKrMatch[1], body), 201);\n }\n const krIdMatch = pathname.match(/^\\/api\\/okrs\\/key-results\\/([^/]+)$/);\n if (krIdMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n return json(await updateKeyResult(krIdMatch[1], body));\n }\n\n // --- NSM routes ----\n if (pathname === \"/api/nsm\" && method === \"GET\") {\n return json(await getNSM());\n }\n if (pathname === \"/api/nsm\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await setNSM(body));\n }\n if (pathname === \"/api/nsm/record\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n await recordNSMValue(body.value);\n return json({ success: true });\n }\n if (pathname === \"/api/nsm/progress\" && method === \"GET\") {\n return json(await getNSMProgress());\n }\n\n // --- AIO / Cohort routes ----\n if (pathname === \"/api/aio/cohorts\" && method === \"GET\") {\n return json(await listCohorts());\n }\n if (pathname === \"/api/aio/cohorts\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createCohort(body), 201);\n }\n const cohortIdMatch = pathname.match(/^\\/api\\/aio\\/cohorts\\/([^/]+)$/);\n if (cohortIdMatch && method === \"DELETE\") {\n return json({ success: await deleteCohort(cohortIdMatch[1]) });\n }\n if (pathname === \"/api/aio/cohort-summary\" && method === \"GET\") {\n return json(await getCohortSummary());\n }\n if (pathname === \"/api/aio/engagement-velocity\" && method === \"GET\") {\n return json(await getEngagementVelocity());\n }\n\n // --- Frontend-expected aliases (cohorts/attribution/key-results) ----\n if (pathname === \"/api/cohorts\" && method === \"GET\") {\n return json(await getCohortSummary());\n }\n if (pathname === \"/api/cohorts\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createCohort(body), 201);\n }\n const cohortAliasMatch = pathname.match(/^\\/api\\/cohorts\\/([^/]+)$/);\n if (cohortAliasMatch && method === \"DELETE\") {\n return json({ success: await deleteCohort(cohortAliasMatch[1]) });\n }\n if (pathname === \"/api/attribution\" && method === \"GET\") {\n return json(await getAttributionSummary());\n }\n // retention (GRR/NRR + curve) + revenue model endpoints.\n if (pathname === \"/api/intelligence/retention\" && method === \"GET\") {\n return json(await getRetention());\n }\n if (pathname === \"/api/intelligence/revenue-model\" && method === \"GET\") {\n return json(await getRevenueModel());\n }\n if (pathname === \"/api/attribution\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n await recordConversion(body);\n return json({ success: true }, 201);\n }\n const krAliasMatch = pathname.match(/^\\/api\\/key-results\\/([^/]+)$/);\n if (krAliasMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n return json(await updateKeyResult(krAliasMatch[1], body));\n }\n\n // --- Digest routes ----\n if (pathname === \"/api/digest\" && method === \"GET\") {\n return json(await getLatestDigest());\n }\n if (pathname === \"/api/digest/generate\" && method === \"POST\") {\n return json(await generateDigest());\n }\n if (pathname === \"/api/digest/history\" && method === \"GET\") {\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"10\", 10);\n return json(await getDigestHistory(limit));\n }\n\n // --- Experiments routes ----\n if (pathname === \"/api/experiments\" && method === \"GET\") {\n const status = url.searchParams.get(\"status\") ?? undefined;\n const funnel_stage = url.searchParams.get(\"stage\") ?? url.searchParams.get(\"funnel_stage\") ?? undefined;\n const aarrr_lever = url.searchParams.get(\"aarrr_lever\") ?? undefined;\n return json(await listExperiments({ status, funnel_stage, aarrr_lever }));\n }\n if (pathname === \"/api/experiments\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createExperiment(body), 201);\n }\n if (pathname === \"/api/experiments/stats\" && method === \"GET\") {\n return json(await getExperimentStats());\n }\n // suggest-ice: alias of ice-suggest (same handler).\n if ((pathname === \"/api/experiments/ice-suggest\" || pathname === \"/api/experiments/suggest-ice\") && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await suggestICE(body));\n }\n // GET /api/experiments/:id/stats — sub-resource form; getExperimentStats() is tenant-aggregate (portfolio-wide).\n // Declared before the run|complete and bare :id matchers so \"stats\" isn't read as an id.\n const expStatsMatch = pathname.match(/^\\/api\\/experiments\\/([^/]+)\\/stats$/);\n if (expStatsMatch && method === \"GET\") {\n return json(await getExperimentStats());\n }\n const expActionMatch = pathname.match(/^\\/api\\/experiments\\/([^/]+)\\/(run|complete)$/);\n if (expActionMatch && method === \"POST\") {\n const id = expActionMatch[1];\n const body = await req.json().catch(() => ({}));\n const result = expActionMatch[2] === \"run\"\n ? await runExperiment(id, Number(body.baseline_value) || 0)\n : await completeExperiment(id, {\n result_value: Number(body.result_value) || 0,\n outcome: body.outcome ?? \"inconclusive\",\n learnings: body.learnings,\n control: body.control,\n variant: body.variant,\n sample_size: body.sample_size,\n });\n return result ? json(result) : json({ error: \"Experiment not found\" }, 404);\n }\n const expIdMatch = pathname.match(/^\\/api\\/experiments\\/([^/]+)$/);\n if (expIdMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n const updated = await updateExperiment(expIdMatch[1], body);\n return updated ? json(updated) : json({ error: \"Experiment not found\" }, 404);\n }\n if (expIdMatch && method === \"DELETE\") {\n const ok = await deleteExperiment(expIdMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // --- Calendar unified route ----\n if (pathname === \"/api/calendar/unified\" && method === \"GET\") {\n const today = new Date().toISOString().slice(0, 10);\n const from = url.searchParams.get(\"from\") ?? url.searchParams.get(\"start\") ?? today;\n const to = url.searchParams.get(\"to\") ?? url.searchParams.get(\"end\") ?? from;\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n const sourcesParam = url.searchParams.getAll(\"source\");\n return json(await getUnifiedCalendar({ from, to, workspace, sources: sourcesParam.length ? sourcesParam as any : undefined }));\n }\n if (pathname === \"/api/calendar/summary\" && method === \"GET\") {\n const date = url.searchParams.get(\"date\") ?? new Date().toISOString().slice(0, 10);\n return json(await getCalendarSummary(date));\n }\n if (pathname === \"/api/calendar/entries\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createCalendarEntry(body), 201);\n }\n const calEntryMatch = pathname.match(/^\\/api\\/calendar\\/entries\\/([^/]+)$/);\n if (calEntryMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n const updated = await updateCalendarEntry(calEntryMatch[1], body);\n return updated ? json(updated) : json({ error: \"Not found\" }, 404);\n }\n if (calEntryMatch && method === \"DELETE\") {\n const ok = await deleteCalendarEntry(calEntryMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // --- Knowledge files (AI knowledge injection + graph view) ----\n if (pathname === \"/api/knowledge\" && method === \"GET\") {\n return json(await listKnowledgeFiles());\n }\n if (pathname === \"/api/knowledge\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const created = await createKnowledgeFile(body);\n return created ? json(created, 201) : json({ error: \"content required\" }, 400);\n }\n if (pathname === \"/api/knowledge/graph\" && method === \"GET\") {\n return json(await buildKnowledgeGraph());\n }\n if (pathname === \"/api/knowledge/features\" && method === \"GET\") {\n return json(AI_FEATURES);\n }\n const knSummarizeMatch = pathname.match(/^\\/api\\/knowledge\\/([^/]+)\\/summarize$/);\n if (knSummarizeMatch && method === \"POST\") {\n const summary = await summarizeKnowledgeFile(knSummarizeMatch[1]);\n const file = await getKnowledgeFile(knSummarizeMatch[1]);\n return json({ summary, tokens_estimate: file?.tokens_estimate ?? 0 });\n }\n const knIdMatch = pathname.match(/^\\/api\\/knowledge\\/([^/]+)$/);\n if (knIdMatch && method === \"GET\") {\n const f = await getKnowledgeFile(knIdMatch[1]);\n return f ? json(f) : json({ error: \"Not found\" }, 404);\n }\n if (knIdMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n const updated = await updateKnowledgeFile(knIdMatch[1], body);\n return updated ? json(updated) : json({ error: \"Not found\" }, 404);\n }\n if (knIdMatch && method === \"DELETE\") {\n const ok = await deleteKnowledgeFile(knIdMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // --- Company Profile + Brand Context (Part 15.2) — the business identity ---\n if (pathname === \"/api/company-profile\" && method === \"GET\") {\n return json(await getCompanyProfile());\n }\n if (pathname === \"/api/company-profile\" && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n return json(await setCompanyProfile(body));\n }\n if (pathname === \"/api/company-profile/enrich\" && method === \"POST\") {\n try {\n const enriched = await enrichCompanyProfile();\n return json({ enriched, message: \"AI enrichment complete — review and save.\" });\n } catch (e) {\n return json({ error: String(e?.message ?? e) }, 500);\n }\n }\n if (pathname === \"/api/brand-context\" && method === \"GET\") {\n return json({ text: await getBrandContext() });\n }\n if (pathname === \"/api/brand-context\" && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n await setBrandContext(String(body.text ?? \"\"));\n return json({ ok: true });\n }\n\n // --- Memory (Part 15.3) — persistent evolving business facts ----\n if (pathname === \"/api/memory\" && method === \"GET\") {\n return json(await listMemory());\n }\n if (pathname === \"/api/memory\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const m = await addMemory(body);\n return m ? json(m, 201) : json({ error: \"content required\" }, 400);\n }\n const memIdMatch = pathname.match(/^\\/api\\/memory\\/([0-9]+)$/);\n if (memIdMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n const m = await updateMemory(Number(memIdMatch[1]), body);\n return m ? json(m) : json({ error: \"Not found\" }, 404);\n }\n if (memIdMatch && method === \"DELETE\") {\n const ok = await deleteMemory(Number(memIdMatch[1]));\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // --- Skills (Playbooks) — marketing skill catalog + per-skill state ----\n if (pathname === \"/api/skills\" && method === \"GET\") {\n return json(await listSkills());\n }\n if (pathname === \"/api/skills\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const created = await createCustomSkill(body);\n return created.ok ? json(created, 201) : json({ error: created.error || \"invalid skill\" }, 400);\n }\n const skillNameMatch = pathname.match(/^\\/api\\/skills\\/([^/]+)$/);\n if (skillNameMatch && method === \"GET\") {\n const s = await getSkill(decodeURIComponent(skillNameMatch[1]));\n return s ? json(s) : json({ error: \"Not found\" }, 404);\n }\n if (skillNameMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n const ok = await setSkillState(decodeURIComponent(skillNameMatch[1]), body);\n return ok ? json({ ok: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // --- Method config (prioritization methodology: ICE/RICE/WSJF) ----\n if (pathname === \"/api/method-config/methods\" && method === \"GET\") {\n return json(getMethodsMetadata());\n }\n if (pathname === \"/api/method-config\" && method === \"GET\") {\n return json(await getMethodConfig());\n }\n if (pathname === \"/api/method-config\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await saveMethodConfig(body));\n }\n\n // --- Action queue (human-in-the-loop execution) ----\n if (pathname === \"/api/actions\" && method === \"GET\") {\n const status = url.searchParams.get(\"status\") ?? undefined;\n return json(await listActions(status));\n }\n if (pathname === \"/api/actions\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const created = await enqueueAction(body);\n return created ? json(created, 201) : json({ error: \"integration + endpoint required\" }, 400);\n }\n const actionApproveMatch = pathname.match(/^\\/api\\/actions\\/([^/]+)\\/approve$/);\n if (actionApproveMatch && method === \"POST\") {\n const a = await approveAction(actionApproveMatch[1]);\n return a ? json(a) : json({ error: \"Not found\" }, 404);\n }\n const actionRejectMatch = pathname.match(/^\\/api\\/actions\\/([^/]+)\\/reject$/);\n if (actionRejectMatch && method === \"POST\") {\n const a = await rejectAction(actionRejectMatch[1]);\n return a ? json(a) : json({ error: \"Not found\" }, 404);\n }\n const actionIdMatch = pathname.match(/^\\/api\\/actions\\/([^/]+)$/);\n if (actionIdMatch && method === \"GET\") {\n const a = await getAction(actionIdMatch[1]);\n return a ? json(a) : json({ error: \"Not found\" }, 404);\n }\n\n // Manual trigger for the execution engine (the interval val also calls processPendingRuns).\n if (pathname === \"/api/agents/run-pending\" && method === \"POST\") {\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"3\", 10);\n return json(await processPendingRuns(limit));\n }\n\n // GET /api/agents/activity?limit=N — cross-agent run feed; before the /api/agents/:id matchers.\n if (pathname === \"/api/agents/activity\" && method === \"GET\") {\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"20\", 10);\n const r = await sqlite.execute(\n `SELECT r.id, r.agent_id, a.name, a.workspace, r.status, r.started_at, r.finished_at, r.output\n FROM agent_runs r LEFT JOIN agents a ON a.id = r.agent_id AND a.tenant_id = ?\n WHERE r.tenant_id = ?\n ORDER BY r.started_at DESC LIMIT ?`,\n [tid, tid, limit]\n );\n return json({ activity: r.rows.map((row) => rowToObject(r.columns, row)) });\n }\n\n // --- Agent runs ----\n const agentRunsMatch = pathname.match(/^\\/api\\/agents\\/([^/]+)\\/runs$/);\n if (agentRunsMatch && method === \"GET\") {\n const agent_id = agentRunsMatch[1];\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"20\", 10);\n const result = await sqlite.execute(\n \"SELECT * FROM agent_runs WHERE agent_id = ? AND tenant_id = ? ORDER BY started_at DESC LIMIT ?\",\n [agent_id, tid, limit]\n );\n return json(result.rows.map((row) => rowToObject(result.columns, row)));\n }\n if (agentRunsMatch && method === \"POST\") {\n const agent_id = agentRunsMatch[1];\n const body = await req.json().catch(() => ({}));\n const id = crypto.randomUUID();\n const now = new Date().toISOString();\n await sqlite.execute(\n \"INSERT INTO agent_runs (id, agent_id, trigger, status, started_at, tenant_id) VALUES (?, ?, ?, ?, ?, ?)\",\n [id, agent_id, body.trigger ?? \"manual\", \"pending\", now, tid]\n );\n // App-level automation (no cron): run the queued job in-request. Fire-and-forget; status='running' claim guards dupes.\n processPendingRuns(1).catch(() => {});\n return json({ id, agent_id, trigger: body.trigger ?? \"manual\", status: \"pending\", started_at: now }, 201);\n }\n\n // Integrations routes\n // GET /api/integrations - list all integrations\n if (pathname === \"/api/integrations\" && method === \"GET\") {\n const result = await sqlite.execute(\"SELECT * FROM integrations WHERE tenant_id = ? ORDER BY name ASC\", [tid]);\n const rows = result.rows.map((row) => rowToObject(result.columns, row));\n // Google-family services inherit the central 'google' OAuth token, so they are \"connected\"\n // whenever google is — even without their own api_key/access_token row.\n const googleConnected = rows.some((o) => o.name === \"google\" && o.access_token);\n const integrations = rows.map((obj) => maskIntegration(obj, googleConnected));\n return json(integrations);\n }\n\n // POST /api/integrations/:name - upsert integration credentials\n const integrationUpsertMatch = pathname.match(/^\\/api\\/integrations\\/([^/]+)$/);\n if (integrationUpsertMatch && method === \"POST\") {\n const name = integrationUpsertMatch[1];\n const body = await req.json().catch(() => ({}));\n const now = new Date().toISOString();\n\n const existing = await sqlite.execute(\n \"SELECT id, api_key, api_secret, access_token, refresh_token, extra_config FROM integrations WHERE name = ? AND tenant_id = ?\",\n [name, tid]\n );\n\n // Keep the existing secret when the incoming value is blank/missing/masked (\"***\"),\n // so saving the masked Settings form does not wipe stored credentials.\n const keepSecret = (incoming: any, current: any) => {\n if (incoming == null) return current ?? null;\n const s = String(incoming);\n if (s === \"\" || s.includes(\"***\")) return current ?? null;\n return incoming;\n };\n\n if (existing.rows.length > 0) {\n const cur = existing.rows[0] as any[]; // [id, api_key, api_secret, access_token, refresh_token, extra_config]\n await sqlite.execute(\n `UPDATE integrations SET\n api_key = ?,\n api_secret = ?,\n access_token = ?,\n refresh_token = ?,\n extra_config = ?,\n updated_at = ?\n WHERE name = ? AND tenant_id = ?`,\n [\n keepSecret(body.api_key, cur[1]),\n keepSecret(body.api_secret, cur[2]),\n keepSecret(body.access_token, cur[3]),\n keepSecret(body.refresh_token, cur[4]),\n body.extra_config != null ? JSON.stringify(body.extra_config) : (cur[5] ?? null),\n now,\n name,\n tid,\n ]\n );\n } else {\n // Insert\n const id = crypto.randomUUID();\n await sqlite.execute(\n `INSERT INTO integrations (id, name, api_key, api_secret, access_token, refresh_token, extra_config, connected_at, updated_at, tenant_id)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n [\n id,\n name,\n body.api_key ?? null,\n body.api_secret ?? null,\n body.access_token ?? null,\n body.refresh_token ?? null,\n body.extra_config != null ? JSON.stringify(body.extra_config) : null,\n now,\n now,\n tid,\n ]\n );\n }\n\n const updated = await sqlite.execute(\n \"SELECT * FROM integrations WHERE name = ? AND tenant_id = ?\",\n [name, tid]\n );\n const raw = rowToObject(updated.columns, updated.rows[0]);\n // NEVER return the just-saved secrets in cleartext — mask like the list endpoint.\n const googleConnected = raw.name === \"google\"\n ? !!raw.access_token\n : !!(await getCredentials(\"google\"))?.access_token;\n return json({ success: true, integration: maskIntegration(raw, googleConnected) });\n }\n\n // DELETE /api/integrations/:name\n const integrationDeleteMatch = pathname.match(/^\\/api\\/integrations\\/([^/]+)$/);\n if (integrationDeleteMatch && method === \"DELETE\") {\n const name = integrationDeleteMatch[1];\n await sqlite.execute(\"DELETE FROM integrations WHERE name = ? AND tenant_id = ?\", [name, tid]);\n return json({ success: true, message: `Integration '${name}' deleted` });\n }\n\n // Part 13: GET /api/integrations/:name/schema — descriptor-generated action/trigger schema\n // (UI form fields + AI tool hints). null when the integration is still hand-written.\n const integrationSchemaMatch = pathname.match(/^\\/api\\/integrations\\/([^/]+)\\/schema$/);\n if (integrationSchemaMatch && method === \"GET\") {\n const schema = getIntegrationSchema(integrationSchemaMatch[1]);\n return schema ? json(schema) : json({ error: \"no descriptor for this integration yet\", descriptor_integrations: listDescriptorNames() }, 404);\n }\n\n // GET|POST /api/integrations/:name/data - proxy to integration API\n const integrationDataMatch = pathname.match(/^\\/api\\/integrations\\/([^/]+)\\/data$/);\n if (integrationDataMatch && (method === \"GET\" || method === \"POST\")) {\n const name = integrationDataMatch[1];\n const credentials = await getCredentials(name);\n if (!credentials) {\n return json({ error: `Integration '${name}' not found or not configured` }, 404);\n }\n return handleIntegrationProxy(req, name, url.searchParams, credentials);\n }\n\n // Agents routes\n // GET /api/agents - list agents (optional ?workspace= query param)\n if (pathname === \"/api/agents\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n const agents = await listAgents(workspace);\n return json(agents);\n }\n\n // POST /api/agents - create agent\n if (pathname === \"/api/agents\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const agent = await createAgent(body);\n return json(agent, 201);\n }\n\n // PUT /api/agents/:id - update agent\n const agentUpdateMatch = pathname.match(/^\\/api\\/agents\\/([^/]+)$/);\n if (agentUpdateMatch && method === \"PUT\") {\n const id = agentUpdateMatch[1];\n const body = await req.json().catch(() => ({}));\n const agent = await updateAgent(id, body);\n if (!agent) {\n return json({ error: `Agent '${id}' not found` }, 404);\n }\n return json(agent);\n }\n\n // DELETE /api/agents/:id - delete agent\n const agentDeleteMatch = pathname.match(/^\\/api\\/agents\\/([^/]+)$/);\n if (agentDeleteMatch && method === \"DELETE\") {\n const id = agentDeleteMatch[1];\n const deleted = await deleteAgent(id);\n if (!deleted) {\n return json({ error: `Agent '${id}' not found` }, 404);\n }\n return json({ success: true, message: `Agent '${id}' deleted` });\n }\n\n // LLM config routes\n // GET /api/llm/config - get LLM config (mask api_key)\n if (pathname === \"/api/llm/config\" && method === \"GET\") {\n const config = await getLLMConfig();\n if (!config) {\n return json({ error: \"LLM config not found\" }, 404);\n }\n // Mask api_key: show first 8 chars + ***\n const masked = {\n ...config,\n api_key: config.api_key\n ? config.api_key.slice(0, 8) + \"***\"\n : \"\",\n };\n return json(masked);\n }\n\n // POST /api/llm/config - save LLM config\n if (pathname === \"/api/llm/config\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const config = await saveLLMConfig(body);\n // Mask api_key in response\n const masked = {\n ...config,\n api_key: config.api_key\n ? config.api_key.slice(0, 8) + \"***\"\n : \"\",\n };\n return json(masked);\n }\n\n // Chat route\n // POST /api/chat - AI chat handler\n if (pathname === \"/api/chat\" && method === \"POST\") {\n return handleChat(req);\n }\n\n // POST /api/chat/stream - SSE streaming chat\n if (pathname === \"/api/chat/stream\" && method === \"POST\") {\n return handleChatStream(req);\n }\n\n // --- Conversation history routes ----\n if (pathname === \"/api/conversations\" && method === \"GET\") {\n return json(await listConversations());\n }\n const convIdMatch = pathname.match(/^\\/api\\/conversations\\/([^/]+)$/);\n if (convIdMatch && method === \"GET\") {\n const conv = await getConversationById(convIdMatch[1]);\n return conv ? json(conv) : json({ error: \"Not found\" }, 404);\n }\n if (convIdMatch && method === \"DELETE\") {\n const ok = await deleteConversation(convIdMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // Tasks routes\n // GET /api/tasks - list tasks (optional ?workspace= query param)\n if (pathname === \"/api/tasks\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n const status = url.searchParams.get(\"status\") ?? undefined;\n return json(await listTasks({ workspace, status }));\n }\n\n // POST /api/tasks - create task\n if (pathname === \"/api/tasks\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createTask(body), 201);\n }\n\n // GET /api/tasks/ice - ICE-ranked backlog (sorted by ICE score desc).\n // Declared before the /api/tasks/:id matchers so \"ice\" isn't read as an id.\n if (pathname === \"/api/tasks/ice\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"50\", 10);\n return json(await listIceRankedTasks({ workspace, limit }));\n }\n\n // POST /api/tasks/generate - LLM-plan tasks from an experiment/KR/objective/campaign.\n if (pathname === \"/api/tasks/generate\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (!body.source_type || !body.source_id) {\n return json({ error: \"source_type and source_id are required\" }, 400);\n }\n return json(await generateTasksFromSource(body), 201);\n }\n\n // POST /api/tasks/:id/run - execute the task with an agent (sub-resource; before the bare :id matchers).\n const taskRunMatch = pathname.match(/^\\/api\\/tasks\\/([^/]+)\\/run$/);\n if (taskRunMatch && method === \"POST\") {\n const result = await runTask(taskRunMatch[1]);\n if (!result.task) return json({ error: result.error || \"Not found\" }, 404);\n return json(result);\n }\n\n // PUT /api/tasks/:id - update task (e.g. toggle status)\n const taskUpdateMatch = pathname.match(/^\\/api\\/tasks\\/([^/]+)$/);\n if (taskUpdateMatch && method === \"PUT\") {\n const id = taskUpdateMatch[1];\n const body = await req.json().catch(() => ({}));\n const updated = await updateTask(id, body);\n if (!updated) return json({ error: \"Not found\" }, 404);\n return json(updated);\n }\n\n // DELETE /api/tasks/:id - delete task\n const taskDeleteMatch = pathname.match(/^\\/api\\/tasks\\/([^/]+)$/);\n if (taskDeleteMatch && method === \"DELETE\") {\n const ok = await deleteTask(taskDeleteMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // --- Relational CRM (accounts + contacts + deal↔contact links) ----\n // Delegate to api/crm_routes.ts; tenant context is already set by main.ts. Kept thin to stay under the 80KB file limit.\n if (isCrmPath(pathname)) return handleCrmRoutes(req, url, method);\n if (isMarketingPath(pathname)) return handleMarketingRoutes(req, url, method);\n\n // --- CRM Deals (sales pipeline) ----\n if (pathname === \"/api/deals\" && method === \"GET\") {\n return json(await listDeals(url.searchParams.get(\"stage\") ?? undefined));\n }\n if (pathname === \"/api/deals\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createDeal(body), 201);\n }\n // Seed deals from qualified leads (explicit; checked before the :id matcher).\n if (pathname === \"/api/deals/sync\" && method === \"POST\") {\n return json(await syncDealsFromLeads());\n }\n // Interactive import: candidate leads to review, then import the selected emails.\n if (pathname === \"/api/deals/candidates\" && method === \"GET\") {\n return json(await listCandidates());\n }\n if (pathname === \"/api/deals/import\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await importDeals(Array.isArray(body.emails) ? body.emails : []));\n }\n const dealIdMatch = pathname.match(/^\\/api\\/deals\\/([^/]+)$/);\n if (dealIdMatch && dealIdMatch[1] !== \"sync\" && method === \"GET\") {\n const d = await getDeal(dealIdMatch[1]);\n return d ? json(d) : json({ error: \"Not found\" }, 404);\n }\n if (dealIdMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n const updated = await updateDeal(dealIdMatch[1], body);\n return updated ? json(updated) : json({ error: \"Not found\" }, 404);\n }\n if (dealIdMatch && method === \"DELETE\") {\n const ok = await deleteDeal(dealIdMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // --- Data export (CSV) ----\n if (pathname === \"/api/export/signals\" && method === \"GET\") {\n const r = await sqlite.execute(\"SELECT id, lead_email, lead_name, signal_type, signal_source, signal_strength, actioned, detected_at FROM intent_signals WHERE tenant_id = ? ORDER BY detected_at DESC\", [tid]);\n const cols = r.columns;\n let csv = cols.join(\",\") + \"\\n\";\n for (const row of r.rows) {\n csv += (row as any[]).map((v) => `\"${String(v ?? \"\").replace(/\"/g, '\"\"')}\"`).join(\",\") + \"\\n\";\n }\n return new Response(csv, { headers: { \"Content-Type\": \"text/csv\", \"Content-Disposition\": 'attachment; filename=\"signals.csv\"', ...corsHeaders } });\n }\n if (pathname === \"/api/export/okrs\" && method === \"GET\") {\n const objR = await sqlite.execute(\"SELECT id, title, description, workspace, status, progress, quarter, created_at FROM objectives WHERE tenant_id = ? ORDER BY created_at DESC\", [tid]);\n const krR = await sqlite.execute(\"SELECT id, objective_id, title, target_value, current_value, unit, progress, updated_at FROM key_results WHERE tenant_id = ? ORDER BY updated_at DESC\", [tid]);\n let csv = \"type,\" + objR.columns.join(\",\") + \"\\n\";\n for (const row of objR.rows) {\n csv += \"objective,\" + (row as any[]).map((v) => `\"${String(v ?? \"\").replace(/\"/g, '\"\"')}\"`).join(\",\") + \"\\n\";\n }\n if (krR.rows.length > 0) {\n csv += \"\\ntype,\" + krR.columns.join(\",\") + \"\\n\";\n for (const row of krR.rows) {\n csv += \"key_result,\" + (row as any[]).map((v) => `\"${String(v ?? \"\").replace(/\"/g, '\"\"')}\"`).join(\",\") + \"\\n\";\n }\n }\n return new Response(csv, { headers: { \"Content-Type\": \"text/csv\", \"Content-Disposition\": 'attachment; filename=\"okrs.csv\"', ...corsHeaders } });\n }\n if (pathname === \"/api/export/tasks\" && method === \"GET\") {\n const r = await sqlite.execute(\"SELECT id, title, description, status, priority, workspace, due_date, created_at, updated_at FROM tasks WHERE tenant_id = ? ORDER BY created_at DESC\", [tid]);\n const cols = r.columns;\n let csv = cols.join(\",\") + \"\\n\";\n for (const row of r.rows) {\n csv += (row as any[]).map((v) => `\"${String(v ?? \"\").replace(/\"/g, '\"\"')}\"`).join(\",\") + \"\\n\";\n }\n return new Response(csv, { headers: { \"Content-Type\": \"text/csv\", \"Content-Disposition\": 'attachment; filename=\"tasks.csv\"', ...corsHeaders } });\n }\n\n // --- LinkedIn OAuth flow (legacy aliases) ----\n if (pathname === \"/api/oauth/linkedin/start\" && method === \"GET\") {\n return Response.redirect(`${url.origin}/api/auth/linkedin`);\n }\n if (pathname === \"/api/oauth/linkedin/callback\" && method === \"GET\") {\n return Response.redirect(`${url.origin}/api/auth/linkedin/callback?${url.search.slice(1)}`);\n }\n\n // --- Graphify - app map for MCP / AI-native navigation ----\n if (pathname === \"/api/graphify\" && method === \"GET\") {\n return json(await getGraphify());\n }\n\n // --- Calendar today shortcut (TodayPanel widget) ----\n if (pathname === \"/api/calendar/today\" && method === \"GET\") {\n const today = new Date().toISOString().slice(0, 10);\n return json(await getUnifiedCalendar({ from: today, to: today }));\n }\n\n // --- Digest latest alias ----\n if (pathname === \"/api/digest/latest\" && method === \"GET\") {\n return json(await getLatestDigest());\n }\n\n // --- PLATFORM SUPERADMIN (master-only; the single audited exception to tenant isolation) ----\n // GATE first, then delegate all /api/platform/* routes to handlePlatformRoutes (api/platform.ts).\n if (pathname.startsWith(\"/api/platform/\")) {\n if (!currentCtx().isPlatformAdmin) return json({ error: \"Forbidden: platform admin only\" }, 403);\n return handlePlatformRoutes(req, url, method);\n }\n\n // --- ADMIN LOCKDOWN: every destructive /api/admin/* route is owner-only (plus per-route confirm\n // tokens below). No-op under default SYSTEM_CTX (role \"owner\"); locks out trial members. ----\n if (pathname.startsWith(\"/api/admin/\") && currentRole() !== \"owner\") {\n return json({ error: \"Forbidden: owner role required\" }, 403);\n }\n\n // Owner bootstrap (owner-only): create/attach the platform owner to t_default for email+password login. Idempotent.\n if (pathname === \"/api/admin/bootstrap-owner\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (!body.email || !body.password) return json({ ok: false, error: \"email + password required\" }, 400);\n const r = await bootstrapOwner(String(body.email), String(body.password));\n return json({ ok: r.ok, created: r.created });\n }\n\n // Admin backup/export (owner-only): read-only, tenant-scoped (WHERE tenant_id=?) JSON snapshot of this tenant's rows.\n // Confirm is optional: pass { confirm: \"EXPORT\" } to be explicit, otherwise it just runs.\n if (pathname === \"/api/admin/export\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm != null && body.confirm !== \"EXPORT\") {\n return json({ ok: false, error: \"Send confirm: EXPORT (or omit confirm)\" }, 400);\n }\n const EXPORT_TABLES = [\n \"tasks\", \"deals\", \"campaigns\", \"objectives\", \"key_results\", \"experiments\",\n \"agents\", \"action_queue\", \"calendar_entries\", \"knowledge_files\", \"notes\",\n ];\n const data: Record = {};\n const counts: Record = {};\n for (const table of EXPORT_TABLES) {\n try {\n const r = await sqlite.execute(`SELECT * FROM ${table} WHERE tenant_id = ?`, [tid]);\n const rows = (r.rows || []).map((row) => rowToObject(r.columns, row));\n data[table] = rows;\n counts[table] = rows.length;\n } catch {\n // Missing table (e.g. not yet created): record empty rather than failing the whole export.\n data[table] = [];\n counts[table] = 0;\n }\n }\n const snapshot = {\n ok: true,\n tenant_id: tid,\n version: APP_VERSION,\n exported_at: new Date().toISOString(),\n tables: EXPORT_TABLES,\n counts,\n data,\n };\n const filename = `aihive-backup-${tid}-${new Date().toISOString().slice(0, 10)}.json`;\n return new Response(JSON.stringify(snapshot, null, 2), {\n headers: {\n \"Content-Type\": \"application/json\",\n \"Content-Disposition\": `attachment; filename=\"${filename}\"`,\n \"Cache-Control\": \"no-store\",\n ...corsHeaders,\n },\n });\n }\n\n // --- Admin purge (clear intelligence cache) ----\n if (pathname === \"/api/admin/purge\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm !== \"PURGE\") return json({ error: \"Send confirm: PURGE\" }, 400);\n await sqlite.execute(\"DELETE FROM intelligence_cache WHERE tenant_id = ?\", [tid]).catch(() => {});\n await sqlite.execute(\"UPDATE app_config SET value=NULL WHERE key='funnel_cache' AND tenant_id = ?\", [tid]).catch(() => {});\n return json({ success: true, message: \"Cache purged\" });\n }\n\n // Remove demo/seed data: starter agents matched exactly on (name, description, system_prompt) so edits are never touched.\n if (pathname === \"/api/admin/seed-status\" && method === \"GET\") {\n let agents = 0;\n for (const seed of DEFAULT_AGENT_SEEDS) {\n const r = await sqlite.execute(\n \"SELECT COUNT(*) FROM agents WHERE name = ? AND description = ? AND system_prompt = ? AND tenant_id = ?\",\n [seed.name, seed.description, seed.system_prompt, tid],\n ).catch(() => null);\n if (r?.rows?.length) agents += Number((r.rows[0] as any[])[0]) || 0;\n }\n return json({ ok: true, total: agents, counts: { agents } });\n }\n if (pathname === \"/api/admin/cleanup-mock\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm !== \"CLEANUP\") return json({ ok: false, error: \"Send confirm: CLEANUP\" }, 400);\n let removed = 0;\n for (const seed of DEFAULT_AGENT_SEEDS) {\n const r = await sqlite.execute(\n \"DELETE FROM agents WHERE name = ? AND description = ? AND system_prompt = ? AND tenant_id = ?\",\n [seed.name, seed.description, seed.system_prompt, tid],\n ).catch(() => null);\n removed += Number((r as any)?.rowsAffected ?? 0) || 0;\n }\n return json({ ok: true, total: removed });\n }\n\n // Bulk reset: wipe ALL agents (= agents + campaigns, same table) plus related\n // run/budget/conversation rows that deleteAgent() does not cascade. Confirm-guarded.\n if (pathname === \"/api/admin/reset-agents\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm !== \"CLEANUP\") return json({ ok: false, error: \"Send confirm: CLEANUP\" }, 400);\n const counts: Record = {};\n for (const table of [\"agents\", \"agent_runs\", \"agent_budgets\", \"conversations\"]) {\n const r = await sqlite.execute(`DELETE FROM ${table} WHERE tenant_id = ?`, [tid]).catch(() => null);\n counts[table] = Number((r as any)?.rowsAffected ?? 0) || 0;\n }\n return json({ ok: true, counts });\n }\n\n // Factory reset (this app + tenant only): wipe the data tables below, keeping integrations/llm_config/knowledge_files. Confirm-guarded.\n if (pathname === \"/api/admin/reset-data\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm !== \"CLEANUP\") return json({ ok: false, error: \"Send confirm: CLEANUP\" }, 400);\n const WIPE_TABLES = [\n \"agents\", \"conversations\", \"agent_budgets\", \"agent_runs\",\n \"objectives\", \"key_results\", \"north_star\", \"nsm_history\",\n \"experiments\", \"tasks\", \"tasks_legacy\", \"notes\",\n \"intent_signals\", \"growth_digests\", \"calendar_entries\", \"action_queue\",\n \"customer_cohorts\", \"lead_state_changes\", \"utm_conversions\",\n \"metric_baselines\", \"metric_history\", \"intelligence_cache\", \"app_config\",\n ];\n const counts: Record = {};\n for (const table of WIPE_TABLES) {\n const r = await sqlite.execute(`DELETE FROM ${table} WHERE tenant_id = ?`, [tid]).catch(() => null);\n counts[table] = Number((r as any)?.rowsAffected ?? 0) || 0;\n }\n return json({ ok: true, kept: [\"integrations\", \"llm_config\", \"knowledge_files\"], counts });\n }\n\n // Precise working-data wipe (KEEPS knowledge_files/skills/memory/app_config/integrations/llm_config). Confirm-guarded.\n if (pathname === \"/api/admin/wipe-working-data\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm !== \"WIPE\") return json({ ok: false, error: \"Send confirm: WIPE\" }, 400);\n const WIPE = [\n \"agents\", \"agent_runs\", \"agent_budgets\", \"conversations\", \"deals\",\n \"experiments\", \"tasks\", \"tasks_legacy\", \"objectives\", \"key_results\",\n \"north_star\", \"nsm_history\", \"intent_signals\", \"growth_digests\",\n \"calendar_entries\", \"action_queue\", \"customer_cohorts\", \"lead_state_changes\",\n \"utm_conversions\", \"metric_baselines\", \"metric_history\", \"intelligence_cache\", \"notes\",\n ];\n const counts: Record = {};\n for (const table of WIPE) {\n const r = await sqlite.execute(`DELETE FROM ${table} WHERE tenant_id = ?`, [tid]).catch(() => null);\n counts[table] = Number((r as any)?.rowsAffected ?? 0) || 0;\n }\n return json({\n ok: true,\n kept: [\"knowledge_files\", \"skills\", \"memory\", \"app_config\", \"integrations\", \"llm_config\"],\n counts,\n });\n }\n\n // --- Targeted wipe: tasks + run history + agents/budgets + campaign↔agent links ONLY ----\n // Keeps campaigns/objectives/everything else. Confirm-guarded.\n if (pathname === \"/api/admin/wipe-tasks-agents\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm !== \"WIPE\") return json({ ok: false, error: \"Send confirm: WIPE\" }, 400);\n const WIPE = [\"tasks\", \"tasks_legacy\", \"agent_runs\", \"agent_budgets\", \"campaign_agents\", \"agents\", \"campaign_runs\"];\n const counts: Record = {};\n for (const table of WIPE) {\n const r = await sqlite.execute(`DELETE FROM ${table} WHERE tenant_id = ?`, [tid]).catch(() => null);\n counts[table] = Number((r as any)?.rowsAffected ?? 0) || 0;\n }\n // Also clear internal completion events (metric_history integration='internal') and task-done\n // calendar markers (event_type='completion'); keep real integration metric history intact.\n const mh = await sqlite.execute(\"DELETE FROM metric_history WHERE integration = 'internal' AND tenant_id = ?\", [tid]).catch(() => null);\n counts[\"metric_history(internal)\"] = Number((mh as any)?.rowsAffected ?? 0) || 0;\n const cm = await sqlite.execute(\"DELETE FROM calendar_entries WHERE event_type = 'completion' AND tenant_id = ?\", [tid]).catch(() => null);\n counts[\"calendar_entries(completion)\"] = Number((cm as any)?.rowsAffected ?? 0) || 0;\n return json({ ok: true, wiped: [...WIPE, \"metric_history(internal)\", \"calendar_entries(completion)\"], counts });\n }\n\n // --- Targeted wipe: action_queue (approvals / prepared+sent action history) ONLY ----\n if (pathname === \"/api/admin/wipe-actions\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n if (body.confirm !== \"WIPE\") return json({ ok: false, error: \"Send confirm: WIPE\" }, 400);\n const r = await sqlite.execute(\"DELETE FROM action_queue WHERE tenant_id = ?\", [tid]).catch(() => null);\n return json({ ok: true, wiped: [\"action_queue\"], counts: { action_queue: Number((r as any)?.rowsAffected ?? 0) || 0 } });\n }\n\n // --- Google OAuth redirect flow ----\n if (pathname === \"/api/auth/google\" && method === \"GET\") {\n const creds = await getCredentials(\"google\");\n // OAuth client is env-driven by design (GOOGLE_CLIENT_ID/SECRET); fall back to the DB row.\n const clientId = Deno.env.get(\"GOOGLE_CLIENT_ID\") || creds?.extra_config?.client_id || creds?.extra_config?.clientId;\n const redirectUri = creds?.extra_config?.redirect_uri || creds?.extra_config?.redirectUri || `${url.origin}/api/auth/google/callback`;\n if (!clientId) {\n return new Response(\"Google OAuth not configured. Add Client ID in Settings - Google.\", { status: 400 });\n }\n const scopes = [\n \"https://www.googleapis.com/auth/userinfo.email\",\n \"https://www.googleapis.com/auth/analytics.readonly\",\n \"https://www.googleapis.com/auth/webmasters.readonly\",\n \"https://www.googleapis.com/auth/gmail.modify\",\n \"https://www.googleapis.com/auth/drive.readonly\",\n \"https://www.googleapis.com/auth/spreadsheets.readonly\",\n \"https://www.googleapis.com/auth/documents.readonly\",\n \"https://www.googleapis.com/auth/calendar\",\n \"https://www.googleapis.com/auth/youtube.readonly\",\n \"https://www.googleapis.com/auth/yt-analytics.readonly\",\n ].join(\" \");\n const { state, setCookie } = newOAuthState();\n const params = new URLSearchParams({\n client_id: clientId,\n redirect_uri: redirectUri,\n response_type: \"code\",\n scope: scopes,\n access_type: \"offline\",\n prompt: \"consent\",\n state,\n });\n return redirectWithCookie(`https://accounts.google.com/o/oauth2/v2/auth?${params}`, setCookie);\n }\n\n if (pathname === \"/api/auth/google/callback\" && method === \"GET\") {\n const code = url.searchParams.get(\"code\");\n const error = url.searchParams.get(\"error\");\n if (error || !code) {\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(error || \"no_code\")}`);\n }\n if (!oauthStateValid(req, url)) {\n return Response.redirect(`${url.origin}/?auth_error=state_mismatch`);\n }\n const creds = await getCredentials(\"google\");\n // Trim env/DB values to avoid whitespace producing a malformed (invalid_request) token request.\n const clientId = (Deno.env.get(\"GOOGLE_CLIENT_ID\") || creds?.extra_config?.client_id || creds?.extra_config?.clientId || \"\").trim();\n const clientSecret = (Deno.env.get(\"GOOGLE_CLIENT_SECRET\") || creds?.api_secret || \"\").trim();\n const redirectUri = (creds?.extra_config?.redirect_uri || creds?.extra_config?.redirectUri || `${url.origin}/api/auth/google/callback`).trim();\n\n // Fail fast with a clear cause if a required param is empty (Google would return invalid_request).\n if (!clientId || !clientSecret) {\n const missing = !clientId && !clientSecret ? \"client_id_and_secret\"\n : !clientId ? \"client_id\" : \"client_secret\";\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(\"missing_\" + missing)}`);\n }\n\n const tokenRes = await fetch(\"https://oauth2.googleapis.com/token\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body: new URLSearchParams({ code, client_id: clientId, client_secret: clientSecret, redirect_uri: redirectUri, grant_type: \"authorization_code\" }),\n });\n const tokens = await tokenRes.json() as any;\n if (!tokenRes.ok || !tokens.access_token) {\n const detail = [tokens.error, tokens.error_description].filter(Boolean).join(\": \") || \"token_exchange_failed\";\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(detail)}`);\n }\n\n const now = new Date().toISOString();\n const newExtraConfig = { ...(creds?.extra_config || {}), token_expiry: Date.now() + (tokens.expires_in || 3600) * 1000 };\n const existing = await sqlite.execute(\"SELECT id FROM integrations WHERE name = ? AND tenant_id = ?\", [\"google\", tid]);\n if (existing.rows.length > 0) {\n await sqlite.execute(\n \"UPDATE integrations SET access_token=?, refresh_token=?, extra_config=?, updated_at=? WHERE name='google' AND tenant_id = ?\",\n [tokens.access_token, tokens.refresh_token || creds?.refresh_token || null, JSON.stringify(newExtraConfig), now, tid]\n );\n } else {\n await sqlite.execute(\n \"INSERT INTO integrations (id, name, access_token, refresh_token, extra_config, connected_at, updated_at, tenant_id) VALUES (?,?,?,?,?,?,?,?)\",\n [crypto.randomUUID(), \"google\", tokens.access_token, tokens.refresh_token || null, JSON.stringify(newExtraConfig), now, now, tid]\n );\n }\n return redirectWithCookie(`${url.origin}/?auth=google_ok`, CLEAR_OAUTH_STATE);\n }\n\n // --- LinkedIn OAuth flow ----\n if (pathname === \"/api/auth/linkedin\" && method === \"GET\") {\n const creds = await getCredentials(\"linkedin\");\n const clientId = creds?.extra_config?.clientId || creds?.extra_config?.client_id;\n const redirectUri = `${url.origin}/api/auth/linkedin/callback`;\n if (!clientId) {\n return new Response(\"LinkedIn OAuth not configured. Add Client ID in Settings - LinkedIn.\", { status: 400 });\n }\n const { state, setCookie } = newOAuthState();\n const params = new URLSearchParams({\n response_type: \"code\",\n client_id: clientId,\n redirect_uri: redirectUri,\n scope: \"openid profile email w_member_social r_basicprofile\",\n state,\n });\n return redirectWithCookie(`https://www.linkedin.com/oauth/v2/authorization?${params}`, setCookie);\n }\n\n if (pathname === \"/api/auth/linkedin/callback\" && method === \"GET\") {\n const code = url.searchParams.get(\"code\");\n const error = url.searchParams.get(\"error\");\n if (error || !code) {\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(error || \"no_code\")}`);\n }\n if (!oauthStateValid(req, url)) {\n return Response.redirect(`${url.origin}/?auth_error=state_mismatch`);\n }\n const creds = await getCredentials(\"linkedin\");\n const clientId = creds?.extra_config?.clientId || creds?.extra_config?.client_id || \"\";\n const clientSecret = creds?.api_secret || \"\";\n const redirectUri = `${url.origin}/api/auth/linkedin/callback`;\n\n const tokenRes = await fetch(\"https://www.linkedin.com/oauth/v2/accessToken\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body: new URLSearchParams({ grant_type: \"authorization_code\", code, redirect_uri: redirectUri, client_id: clientId, client_secret: clientSecret }),\n });\n const tokens = await tokenRes.json() as any;\n if (!tokenRes.ok || !tokens.access_token) {\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(tokens.error || \"linkedin_token_failed\")}`);\n }\n\n // Fetch LinkedIn profile to get the author URN needed for posts endpoint.\n let authorId = creds?.extra_config?.author_id || \"\";\n try {\n const profileRes = await fetch(\"https://api.linkedin.com/v2/me\", {\n headers: { Authorization: `Bearer ${tokens.access_token}` },\n });\n if (profileRes.ok) {\n const profile = await profileRes.json() as any;\n if (profile.id) authorId = `urn:li:person:${profile.id}`;\n }\n } catch { /* non-fatal - author_id can be set manually later */ }\n\n const now = new Date().toISOString();\n const newExtraConfig = { ...(creds?.extra_config || {}), token_expiry: Date.now() + (tokens.expires_in || 5184000) * 1000, author_id: authorId };\n const existing = await sqlite.execute(\"SELECT id FROM integrations WHERE name = ? AND tenant_id = ?\", [\"linkedin\", tid]);\n if (existing.rows.length > 0) {\n await sqlite.execute(\n \"UPDATE integrations SET access_token=?, extra_config=?, updated_at=? WHERE name='linkedin' AND tenant_id = ?\",\n [tokens.access_token, JSON.stringify(newExtraConfig), now, tid]\n );\n } else {\n await sqlite.execute(\n \"INSERT INTO integrations (id, name, access_token, extra_config, connected_at, updated_at, tenant_id) VALUES (?,?,?,?,?,?,?)\",\n [crypto.randomUUID(), \"linkedin\", tokens.access_token, JSON.stringify(newExtraConfig), now, now, tid]\n );\n }\n return redirectWithCookie(`${url.origin}/?auth=linkedin_ok`, CLEAR_OAUTH_STATE);\n }\n\n // Microsoft (Outlook) OAuth: env-first client (MICROSOFT_CLIENT_ID/SECRET), `common` tenant, DB fallback. Mirrors Google.\n if (pathname === \"/api/auth/microsoft\" && method === \"GET\") {\n const mcreds = await getCredentials(\"outlook\");\n const clientId = (Deno.env.get(\"MICROSOFT_CLIENT_ID\") || mcreds?.extra_config?.client_id || mcreds?.extra_config?.clientId || \"\").trim();\n if (!clientId) {\n return new Response(\"Microsoft OAuth not configured. Set MICROSOFT_CLIENT_ID (env) or add the Client ID in Settings → Outlook.\", { status: 400 });\n }\n const redirectUri = `${url.origin}/api/auth/microsoft/callback`;\n const scopes = MICROSOFT_SCOPES;\n const { state, setCookie } = newOAuthState();\n const params = new URLSearchParams({\n client_id: clientId,\n response_type: \"code\",\n redirect_uri: redirectUri,\n response_mode: \"query\",\n scope: scopes,\n state,\n });\n return redirectWithCookie(`https://login.microsoftonline.com/common/oauth2/v2.0/authorize?${params}`, setCookie);\n }\n\n if (pathname === \"/api/auth/microsoft/callback\" && method === \"GET\") {\n const code = url.searchParams.get(\"code\");\n const error = url.searchParams.get(\"error\");\n if (error || !code) {\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(error || \"no_code\")}`);\n }\n if (!oauthStateValid(req, url)) {\n return Response.redirect(`${url.origin}/?auth_error=state_mismatch`);\n }\n const creds = await getCredentials(\"outlook\");\n const clientId = (Deno.env.get(\"MICROSOFT_CLIENT_ID\") || creds?.extra_config?.client_id || creds?.extra_config?.clientId || \"\").trim();\n const clientSecret = (Deno.env.get(\"MICROSOFT_CLIENT_SECRET\") || creds?.api_secret || \"\").trim();\n const redirectUri = `${url.origin}/api/auth/microsoft/callback`;\n if (!clientId || !clientSecret) {\n const missing = !clientId && !clientSecret ? \"client_id_and_secret\" : !clientId ? \"client_id\" : \"client_secret\";\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(\"missing_microsoft_\" + missing)}`);\n }\n const scopes = MICROSOFT_SCOPES;\n const tokenRes = await fetch(\"https://login.microsoftonline.com/common/oauth2/v2.0/token\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body: new URLSearchParams({ client_id: clientId, client_secret: clientSecret, code, redirect_uri: redirectUri, grant_type: \"authorization_code\", scope: scopes }),\n });\n const tokens = await tokenRes.json() as any;\n if (!tokenRes.ok || !tokens.access_token) {\n const detail = [tokens.error, tokens.error_description].filter(Boolean).join(\": \") || \"token_exchange_failed\";\n return Response.redirect(`${url.origin}/?auth_error=${encodeURIComponent(detail)}`);\n }\n\n const now = new Date().toISOString();\n const newExtraConfig = { ...(creds?.extra_config || {}), token_expiry: Date.now() + (tokens.expires_in || 3600) * 1000 };\n const existing = await sqlite.execute(\"SELECT id FROM integrations WHERE name = ? AND tenant_id = ?\", [\"outlook\", tid]);\n if (existing.rows.length > 0) {\n await sqlite.execute(\n \"UPDATE integrations SET access_token=?, refresh_token=?, extra_config=?, updated_at=? WHERE name='outlook' AND tenant_id = ?\",\n [tokens.access_token, tokens.refresh_token || creds?.refresh_token || null, JSON.stringify(newExtraConfig), now, tid]\n );\n } else {\n await sqlite.execute(\n \"INSERT INTO integrations (id, name, access_token, refresh_token, extra_config, connected_at, updated_at, tenant_id) VALUES (?,?,?,?,?,?,?,?)\",\n [crypto.randomUUID(), \"outlook\", tokens.access_token, tokens.refresh_token || null, JSON.stringify(newExtraConfig), now, now, tid]\n );\n }\n return redirectWithCookie(`${url.origin}/?auth=outlook_ok`, CLEAR_OAUTH_STATE);\n }\n\n // Identity login OAuth (sign-in, NOT data scopes): scope \"openid email profile\"; callback mints an app session.\n const loginMatch = pathname.match(/^\\/api\\/login\\/(google|microsoft)(\\/callback)?$/);\n if (loginMatch && method === \"GET\") {\n const provider = loginMatch[1] as \"google\" | \"microsoft\";\n return loginMatch[2]\n ? await identityLoginCallback(provider, req, url)\n : identityLoginStart(provider, url);\n }\n\n // --- Notes routes (TeamHub collaborative notes) ----\n if (pathname === \"/api/notes\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? \"marketing\";\n const result = await sqlite.execute(\n \"SELECT * FROM notes WHERE workspace=? AND tenant_id = ? ORDER BY pinned DESC, created_at DESC\",\n [workspace, tid]\n );\n return json(result.rows.map((r) => rowToObject(result.columns, r)));\n }\n if (pathname === \"/api/notes\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n const id = crypto.randomUUID();\n const now = new Date().toISOString();\n await sqlite.execute(\n \"INSERT INTO notes (id, content, pinned, workspace, created_at, updated_at, tenant_id) VALUES (?,?,?,?,?,?,?)\",\n [id, body.content ?? \"\", body.pinned ? 1 : 0, body.workspace ?? \"marketing\", now, now, tid]\n );\n return json({ id, content: body.content ?? \"\", pinned: !!body.pinned, workspace: body.workspace ?? \"marketing\", created_at: now, updated_at: now }, 201);\n }\n const noteMatch = pathname.match(/^\\/api\\/notes\\/([^/]+)$/);\n if (noteMatch && method === \"PUT\") {\n const id = noteMatch[1];\n const body = await req.json().catch(() => ({}));\n const now = new Date().toISOString();\n const setParts: string[] = [\"updated_at=?\"];\n const setArgs: any[] = [now];\n if (body.pinned !== undefined) { setParts.push(\"pinned=?\"); setArgs.push(body.pinned ? 1 : 0); }\n if (body.content !== undefined) { setParts.push(\"content=?\"); setArgs.push(body.content); }\n await sqlite.execute(\n `UPDATE notes SET ${setParts.join(\", \")} WHERE id=? AND tenant_id = ?`,\n [...setArgs, id, tid]\n );\n const r = await sqlite.execute(\"SELECT * FROM notes WHERE id=? AND tenant_id = ?\", [id, tid]);\n if (!r.rows.length) return json({ error: \"Not found\" }, 404);\n return json(rowToObject(r.columns, r.rows[0]));\n }\n if (noteMatch && method === \"DELETE\") {\n await sqlite.execute(\"DELETE FROM notes WHERE id=? AND tenant_id = ?\", [noteMatch[1], tid]);\n return json({ success: true });\n }\n\n // --- World dashboard rollups (logs / kanban / project panels) ----\n // /api/world/activity — cross-agent runs; ?campaign[_id]=ID scopes to that campaign, bare ?campaign = legacy filter.\n if (pathname === \"/api/world/activity\" && method === \"GET\") {\n const limit = parseInt(url.searchParams.get(\"limit\") ?? \"40\", 10);\n const status = url.searchParams.get(\"status\") ?? undefined;\n const agent_id = url.searchParams.get(\"agent_id\") ?? undefined;\n const campaignParam = url.searchParams.get(\"campaign_id\") ?? url.searchParams.get(\"campaign\");\n const campaign_id = campaignParam ? campaignParam : undefined;\n const campaign = url.searchParams.get(\"campaign\") != null && !campaign_id;\n return json(await getWorldActivity({ limit, status, agent_id, campaign, campaign_id }));\n }\n // /api/world/board — tasks grouped into the 4 kanban columns; ?campaign[_id]=ID scopes them.\n if (pathname === \"/api/world/board\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n const campaign_id = url.searchParams.get(\"campaign_id\") ?? url.searchParams.get(\"campaign\") ?? undefined;\n return json(await getWorldBoard({ workspace, campaign_id: campaign_id || undefined }));\n }\n // /api/world/project — active campaign brief + real run-usage rollup; ?campaign[_id]=ID focuses it.\n if (pathname === \"/api/world/project\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n const campaign_id = url.searchParams.get(\"campaign_id\") ?? url.searchParams.get(\"campaign\") ?? undefined;\n return json(await getWorldProject({ workspace, campaign_id: campaign_id || undefined }));\n }\n\n // --- Campaigns (Director: multi-agent orchestrated pipelines) ----\n if (pathname === \"/api/campaigns\" && method === \"GET\") {\n const workspace = url.searchParams.get(\"workspace\") ?? undefined;\n return json(await listCampaigns(workspace));\n }\n if (pathname === \"/api/campaigns\" && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await createCampaign(body), 201);\n }\n // Sub-resources (:id/runs, :id/agents, :id/trigger) before the bare :id matcher.\n const campaignRunsMatch = pathname.match(/^\\/api\\/campaigns\\/([^/]+)\\/runs$/);\n if (campaignRunsMatch && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n // Runs the Director pipeline synchronously and returns the run result.\n return json(await orchestrateCampaignRun(campaignRunsMatch[1], body.input));\n }\n if (campaignRunsMatch && method === \"GET\") {\n return json(await listCampaignRuns(campaignRunsMatch[1]));\n }\n const campaignAgentsMatch = pathname.match(/^\\/api\\/campaigns\\/([^/]+)\\/agents$/);\n if (campaignAgentsMatch && method === \"GET\") {\n return json(await getCampaignAgents(campaignAgentsMatch[1]));\n }\n // Clicking a campaign returns its tasks (OKR→Campaign→Task link).\n const campaignTasksMatch = pathname.match(/^\\/api\\/campaigns\\/([^/]+)\\/tasks$/);\n if (campaignTasksMatch && method === \"GET\") {\n return json(await listTasks({ campaign_id: campaignTasksMatch[1] }));\n }\n const campaignTriggerMatch = pathname.match(/^\\/api\\/campaigns\\/([^/]+)\\/trigger$/);\n if (campaignTriggerMatch && method === \"POST\") {\n const body = await req.json().catch(() => ({}));\n return json(await setCampaignTrigger(campaignTriggerMatch[1], body));\n }\n const campaignIdMatch = pathname.match(/^\\/api\\/campaigns\\/([^/]+)$/);\n if (campaignIdMatch && method === \"GET\") {\n const c = await getCampaign(campaignIdMatch[1]);\n return c ? json(c) : json({ error: \"Not found\" }, 404);\n }\n if (campaignIdMatch && method === \"PUT\") {\n const body = await req.json().catch(() => ({}));\n return json(await updateCampaign(campaignIdMatch[1], body));\n }\n if (campaignIdMatch && method === \"DELETE\") {\n const ok = await deleteCampaign(campaignIdMatch[1]);\n return ok ? json({ success: true }) : json({ error: \"Not found\" }, 404);\n }\n\n // No route matched\n return json({ error: \"Not found\", path: pathname }, 404);\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n console.error(`[router] Error handling ${method} ${pathname}:`, message);\n return json({ error: \"Internal server error\", detail: message }, 500);\n }\n}\n\n/**\n * Converts a sqlite result row (array of values) to a plain object\n * using the columns array from the result set.\n */\nfunction rowToObject(columns: string[], row: unknown[]): Record {\n const obj: Record = {};\n for (let i = 0; i < columns.length; i++) {\n obj[columns[i]] = row[i];\n }\n return obj;\n}\n",[184],"252942b0-5ef9-11f1-b21e-1607ee4eb77e","main.ts",959,["D",1780455958842],21,"http","import { initDB, tenantStore, SYSTEM_CTX } from \"./db.ts\";\nimport { handleRequest } from \"./router.ts\";\nimport { getFrontendHTML, getWorldHTML } from \"./frontend.ts\";\nimport { seedKnowledge } from \"./api/knowledge_seed.ts\";\nimport { resolveSession } from \"./api/session.ts\";\n\n// Foundation tenant context: a session resolves to a TenantCtx; absent one we fall back to the\n// system/default SYSTEM_CTX (imported from db.ts, typed as TenantCtx) so all existing\n// (t_default-backfilled) data keeps working exactly as today.\n\nlet initialized = false;\n\n// Shared-secret gate. Set APP_TOKEN in the val's environment. Every /api/* route\n// requires `Authorization: Bearer ` (or `?token=` for download links),\n// EXCEPT the public paths below. Fail-closed: if APP_TOKEN is unset, data routes 503.\nconst APP_TOKEN = (Deno.env.get(\"APP_TOKEN\") || \"\").trim();\n\n// Auth ENABLED (Phase 3): /api/* requires a valid nexus_session cookie OR the APP_TOKEN bearer\n// (recovery hatch). Public paths (app modules, /api/auth/*, /api/login/*, /api/health) stay open so\n// the login screen always loads. Verified: owner session authorizes, anonymous → 401 → login screen.\nconst AUTH_DISABLED = false;\n\n// Public /api paths that must stay reachable without the app token:\n// - /api/app-* : the frontend's own JS modules (static code, no secrets; loaded by \n \n \n \n \n \n \n \n \n\n\n

\n \n\n`;\n}\n\n// Part 10: the Agent World shell — a \"the-delegation\" simulation DASHBOARD at /world. Same origin\n// (shares nexus_token + every /api/* route), so the agents + panels run over the REAL backend.\n// This shell is the SOLE creator of every fixed DOM id the world modules target. It is a CSS-grid\n// dashboard (light theme): a top bar, a LEFT logs panel, a CENTER stage (scene header + a BOUNDED\n// canvas + a kanban under it) and a RIGHT project panel. The canvas is NOT fullscreen — it lives\n// inside #world-canvas-wrap and the scene sizes to that wrapper. three.js (+ addons) load from a\n// CDN via the importmap; the 3D + panel logic is in /api/app-world (the entry) and its sub-modules.\nexport function getWorldHTML(): string {\n return `\n\n\n \n \n AIHive · Agent World\n \n \n \n \n\n\n

\n \n

\n \n\n`;\n}\n",[434],"057d706e-5f15-11f1-9917-1607ee4eb77e","db.ts","2f68e1b8-56ca-11f1-b821-ee650bb23af1",999,["D",1780467931614],52,"import { sqlite as _sqlite } from \"https://esm.town/v/std/sqlite\";\n\n// Compatibility shim: support sqlite.execute(sql, args) two-arg form\n// Val.town's libSQL client only accepts execute(string) or execute({sql, args})\nconst _exec = _sqlite.execute.bind(_sqlite);\n\n// RATE-LIMIT RESILIENCE: std/sqlite enforces a shared rate limit. A cold-boot initDB fires ~170\n// CREATE/ALTER/INDEX calls in a burst and can exceed the window MID-init — which used to wedge the\n// whole app in a permanent 500 loop (init fails part-way → memo resets → next request re-bursts →\n// fails again, never converging). We retry rate-limited calls with backoff so init (and any runtime\n// query) PACES THROUGH the limit and completes. Non-rate-limit errors are rethrown immediately.\nconst _isRateLimit = (e: any): boolean => /rate limit|too many request|429/i.test(String((e && e.message) || e));\nconst _backoffMs = (e: any, attempt: number): number => {\n const m = String((e && e.message) || e).match(/retry in (\\d+)\\s*second/i);\n if (m) return Math.min(8000, (Number(m[1]) + 1) * 1000); // honor the server's hint when given\n return Math.min(4000, 500 * Math.pow(2, attempt));\n};\nconst _execRetry = async (stmt: any): Promise => {\n for (let attempt = 0; ; attempt++) {\n try {\n return await _exec(stmt);\n } catch (e) {\n if (attempt < 10 && _isRateLimit(e)) {\n await new Promise((r) => setTimeout(r, _backoffMs(e, attempt)));\n continue;\n }\n throw e;\n }\n }\n};\nexport const sqlite = {\n ..._sqlite,\n execute: async (stmt: string | { sql: string; args?: any[] }, args?: any[]): Promise => {\n if (typeof stmt === \"string\" && args !== undefined) {\n return _execRetry({ sql: stmt, args });\n }\n return _execRetry(stmt as any);\n },\n};\n\n// ─── TENANT CONTEXT (AUTH/TENANT FOUNDATION) ────────────────────────────────\n// Per-request tenant/user/role context carried via AsyncLocalStorage. main.ts wraps each\n// handleRequest in tenantStore.run(ctx, ...). When there is no active store (cron, system\n// boot, recovery APP_TOKEN path) we DEFAULT to t_default/system/owner so all existing data\n// (backfilled to tenant_id=\"t_default\") keeps working exactly as today.\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\n// impersonating / realTenantId are set ONLY for read-only \"view as tenant\" (Phase D): when a\n// platform admin toggles sessions.impersonate_tenant_id, resolveSessionToken redirects tenantId to\n// the target tenant while keeping userId/email/role/isPlatformAdmin = the master. realTenantId holds\n// the master's OWN membership tenant. Optional so every existing ctx literal stays valid.\nexport type TenantCtx = { tenantId: string; userId: string; email: string; role: \"owner\" | \"admin\" | \"member\"; isPlatformAdmin: boolean; impersonating?: boolean; realTenantId?: string };\n// SYSTEM_CTX is the platform-trusted recovery context (APP_TOKEN / cron / boot). It IS platform admin.\nexport const SYSTEM_CTX: TenantCtx = { tenantId: \"t_default\", userId: \"system\", email: \"system\", role: \"owner\", isPlatformAdmin: true };\n\nexport const tenantStore = new AsyncLocalStorage();\nexport function currentCtx(): TenantCtx {\n // The bare no-store default is intentionally NOT platform admin (safe-by-default). Only the\n // explicit SYSTEM_CTX (used by main.ts for cron/recovery) carries isPlatformAdmin:true.\n return tenantStore.getStore() || { tenantId: \"t_default\", userId: \"system\", email: \"system\", role: \"owner\", isPlatformAdmin: false };\n}\nexport function currentTenantId(): string { return currentCtx().tenantId; }\nexport function currentUserId(): string { return currentCtx().userId; }\nexport function currentRole(): \"owner\" | \"admin\" | \"member\" { return currentCtx().role; }\n\n// MEMOIZED: run the full schema setup ONCE per warm instance, not on every request. initDB was\n// awaited per-request, firing dozens of CREATE/ALTER sqlite calls each time → std/sqlite 429\n// \"Too Many Requests\" → intermittent 500s across the app (the \"too many requests\" symptom). The\n// cached promise makes every subsequent call free; on failure we reset so the next request retries.\nlet _initPromise: Promise | null = null;\nexport function initDB(): Promise {\n if (!_initPromise) {\n _initPromise = _initDBImpl().catch((e) => { _initPromise = null; throw e; });\n }\n return _initPromise;\n}\nasync function _initDBImpl(): Promise {\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS integrations (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n api_key TEXT,\n api_secret TEXT,\n access_token TEXT,\n refresh_token TEXT,\n extra_config TEXT,\n connected_at TEXT,\n updated_at TEXT,\n tenant_id TEXT,\n UNIQUE(tenant_id, name)\n )\n `);\n\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS llm_config (\n id TEXT PRIMARY KEY DEFAULT 'default',\n provider TEXT NOT NULL DEFAULT 'anthropic',\n api_key TEXT NOT NULL DEFAULT '',\n endpoint TEXT,\n model TEXT NOT NULL DEFAULT 'claude-sonnet-4-6',\n updated_at TEXT\n )\n `);\n\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS agents (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n workspace TEXT NOT NULL,\n description TEXT,\n system_prompt TEXT,\n tools TEXT DEFAULT '[]',\n model TEXT,\n enabled INTEGER DEFAULT 1,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n created_by TEXT DEFAULT 'user'\n )\n `);\n\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS conversations (\n id TEXT PRIMARY KEY,\n agent_id TEXT,\n workspace TEXT NOT NULL,\n messages TEXT DEFAULT '[]',\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL\n )\n `);\n\n // F4 migration: the original tasks table (TEXT id, agent_id, input/output) is replaced by\n // the framework-layer tasks schema (INTEGER id, ICE fields, OKR/experiment links). If a\n // legacy table exists, rename it so the new CREATE further down can build the right shape.\n try {\n const cols = await sqlite.execute(\"PRAGMA table_info(tasks)\");\n const have = new Set((cols.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n // Old schema is identifiable by `agent_id` + `input` + no `priority`. New schema has `priority` + `ice_score`.\n const isLegacy = have.has(\"agent_id\") && have.has(\"input\") && !have.has(\"ice_score\");\n if (isLegacy) {\n await sqlite.execute(\"ALTER TABLE tasks RENAME TO tasks_legacy\");\n }\n } catch { /* table doesn't exist yet — fine, new CREATE will run */ }\n\n // Co-working: shared notes for team collaboration on strategies.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS notes (\n id TEXT PRIMARY KEY,\n author TEXT,\n content TEXT NOT NULL,\n workspace TEXT,\n pinned INTEGER DEFAULT 0,\n created_at TEXT NOT NULL,\n updated_at TEXT\n )\n `);\n\n // Intelligence layer: per-metric 30d baselines used for health scoring.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS metric_baselines (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n integration TEXT NOT NULL,\n metric_key TEXT NOT NULL,\n baseline_value REAL,\n baseline_period TEXT DEFAULT '30d',\n last_updated TEXT DEFAULT (datetime('now')),\n UNIQUE(integration, metric_key)\n )\n `);\n\n // Intelligence cache — funnel summary, correlations, recommendations, LLM-generated feed.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS intelligence_cache (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n cache_key TEXT UNIQUE NOT NULL,\n payload TEXT NOT NULL,\n generated_at TEXT DEFAULT (datetime('now')),\n expires_at TEXT NOT NULL\n )\n `);\n\n // App-wide key/value config: ROI inputs (avg_deal_size, est_marketing_spend),\n // workspace preferences (ultra_density, translucency, hardware_accel, etc.).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS app_config (\n key TEXT PRIMARY KEY,\n value TEXT,\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n\n // Metric history — rolling timeseries for delta_7d / delta_30d computations.\n // Pruned to last 60 days on insert to keep size bounded.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS metric_history (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n integration TEXT NOT NULL,\n metric_key TEXT NOT NULL,\n value REAL NOT NULL,\n recorded_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_metric_history_key ON metric_history(integration, metric_key, recorded_at DESC)`);\n\n // A5: rolling baseline columns — added on existing metric_baselines tables via\n // PRAGMA-guarded ALTER so we never fail on re-run.\n try {\n const cols = await sqlite.execute(\"PRAGMA table_info(metric_baselines)\");\n const have = new Set((cols.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!have.has(\"rolling_avg\")) {\n await sqlite.execute(\"ALTER TABLE metric_baselines ADD COLUMN rolling_avg REAL\");\n }\n if (!have.has(\"sample_count\")) {\n await sqlite.execute(\"ALTER TABLE metric_baselines ADD COLUMN sample_count INTEGER DEFAULT 0\");\n }\n } catch { /* non-critical: warm-start baselines still work */ }\n\n // QA fix: per-provider key columns on llm_config so switching providers doesn't\n // overwrite the previous provider's key. PRAGMA-guarded ALTER (re-run safe).\n try {\n const cols = await sqlite.execute(\"PRAGMA table_info(llm_config)\");\n const have = new Set((cols.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n for (const col of [\"api_key_anthropic\", \"api_key_openai\", \"api_key_gemini\", \"api_key_custom\"]) {\n if (!have.has(col)) await sqlite.execute(`ALTER TABLE llm_config ADD COLUMN ${col} TEXT DEFAULT ''`);\n }\n if (!have.has(\"endpoint_custom\")) {\n await sqlite.execute(\"ALTER TABLE llm_config ADD COLUMN endpoint_custom TEXT DEFAULT ''\");\n }\n } catch { /* non-critical: legacy single-key still works */ }\n\n // Agent budget tracking — real monthly LLM-cost cap per agent.\n // current_spend incremented on each LLM call, reset at period_start rollover.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS agent_budgets (\n agent_id TEXT PRIMARY KEY,\n monthly_cap REAL DEFAULT 250,\n current_spend REAL DEFAULT 0,\n period_start TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n\n // C3: agent execution log. One row per run (manual or scheduled). Latest 50 power the\n // AgentCard timeline. status: queued → running → completed | failed | cancelled.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS agent_runs (\n id TEXT PRIMARY KEY,\n agent_id TEXT NOT NULL,\n status TEXT NOT NULL,\n trigger TEXT DEFAULT 'manual',\n started_at TEXT DEFAULT (datetime('now')),\n finished_at TEXT,\n duration_ms INTEGER,\n input TEXT,\n output TEXT,\n error TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_agent_runs_agent ON agent_runs(agent_id, started_at DESC)`);\n\n // D1: customer cohorts. One row per cohort (e.g. signup month). Powers cohort-survival LTV\n // beyond the simple avg_deal × retention_months heuristic. retention_curve is a JSON array\n // [m1, m2, m3 ...] of retained customer counts. arpu = average revenue per user (monthly).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS customer_cohorts (\n id TEXT PRIMARY KEY,\n cohort_label TEXT NOT NULL,\n cohort_size INTEGER NOT NULL,\n arpu REAL NOT NULL,\n retention_curve TEXT NOT NULL,\n created_at TEXT DEFAULT (datetime('now'))\n )\n `);\n\n // D3: lead state changes — every MQL→SQL transition gets a row so we can compute\n // engagement velocity (avg days lead spent in each stage).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS lead_state_changes (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n lead_email TEXT NOT NULL,\n from_state TEXT,\n to_state TEXT NOT NULL,\n changed_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_lead_state_email ON lead_state_changes(lead_email, changed_at)`);\n\n // D5: utm_conversions — channel attribution log. Populated when a conversion fires\n // (manually pushed via POST /api/attribution or scraped from GA4 in a later phase).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS utm_conversions (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n utm_source TEXT,\n utm_medium TEXT,\n utm_campaign TEXT,\n conversion_value REAL DEFAULT 0,\n converted_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_utm_source ON utm_conversions(utm_source, converted_at DESC)`);\n\n // ─── FRAMEWORK LAYER (F1-F4): NSM, OKRs, Experiments, Tasks ─────────────────\n\n // F1: North Star Metric (singleton — only one active row; previous deleted on set)\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS north_star (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n metric_name TEXT NOT NULL,\n metric_source TEXT NOT NULL,\n metric_key TEXT,\n current_value REAL,\n target_value REAL NOT NULL,\n target_date TEXT NOT NULL,\n unit TEXT DEFAULT 'count',\n description TEXT,\n set_at TEXT DEFAULT (datetime('now')),\n set_by TEXT DEFAULT 'admin'\n )\n `);\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS nsm_history (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n nsm_id INTEGER REFERENCES north_star(id) ON DELETE CASCADE,\n value REAL NOT NULL,\n recorded_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_nsm_history_id ON nsm_history(nsm_id, recorded_at DESC)`);\n\n // F2: OKRs (Objectives + Key Results)\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS objectives (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n title TEXT NOT NULL,\n description TEXT,\n quarter TEXT NOT NULL,\n workspace TEXT DEFAULT 'marketing',\n owner TEXT,\n status TEXT DEFAULT 'active',\n progress REAL DEFAULT 0,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS key_results (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n objective_id INTEGER NOT NULL REFERENCES objectives(id) ON DELETE CASCADE,\n title TEXT NOT NULL,\n metric_source TEXT,\n metric_key TEXT,\n start_value REAL DEFAULT 0,\n current_value REAL DEFAULT 0,\n target_value REAL NOT NULL,\n unit TEXT DEFAULT 'count',\n confidence REAL DEFAULT 0.5,\n progress REAL DEFAULT 0,\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_kr_objective ON key_results(objective_id)`);\n\n // F3: ICE Experiments (ice_score + uplift_pct computed in app code — sqlite GENERATED\n // column support is uneven; safer to project them client-side from impact/confidence/ease).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS experiments (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n title TEXT NOT NULL,\n hypothesis TEXT,\n objective_id INTEGER REFERENCES objectives(id) ON DELETE SET NULL,\n funnel_stage TEXT,\n aarrr_lever TEXT,\n status TEXT DEFAULT 'idea',\n impact REAL DEFAULT 5,\n confidence REAL DEFAULT 5,\n ease REAL DEFAULT 5,\n owner TEXT,\n start_date TEXT,\n end_date TEXT,\n channel TEXT,\n success_metric TEXT,\n baseline_value REAL,\n result_value REAL,\n outcome TEXT,\n learnings TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_exp_status ON experiments(status, updated_at DESC)`);\n\n // F4: Tasks (linked to OKRs / KRs / experiments — at least one for governance).\n // NOTE: the gap-closure prompt also referred to a \"tasks\" table — the older one (string id,\n // status enum 'pending|running|done|failed') is replaced by this richer schema. The two\n // were never wired to a shared UI so the swap is safe.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS tasks (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n title TEXT NOT NULL,\n description TEXT,\n status TEXT DEFAULT 'todo',\n priority TEXT DEFAULT 'medium',\n workspace TEXT DEFAULT 'marketing',\n assignee TEXT,\n due_date TEXT,\n objective_id INTEGER REFERENCES objectives(id) ON DELETE SET NULL,\n key_result_id INTEGER REFERENCES key_results(id) ON DELETE SET NULL,\n experiment_id INTEGER REFERENCES experiments(id) ON DELETE SET NULL,\n ice_score REAL,\n impact REAL,\n confidence REAL,\n ease REAL,\n tags TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n completed_at TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status, due_date)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_tasks_links ON tasks(experiment_id, key_result_id, objective_id)`);\n\n // OKR→Campaign→Task link: a task can belong to a campaign (the higher-level container).\n // Completing the task rolls progress up through the campaign to its objective. PRAGMA-guarded\n // ALTER so existing tasks tables gain the column without failing on re-run.\n try {\n const tc = await sqlite.execute(\"PRAGMA table_info(tasks)\");\n const tHave = new Set((tc.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!tHave.has(\"campaign_id\")) await sqlite.execute(\"ALTER TABLE tasks ADD COLUMN campaign_id TEXT\");\n } catch { /* non-critical: tasks without a campaign link still work */ }\n\n // ─── INTELLIGENCE LAYER EXTENSIONS (I1, I4): Signals + Digests ──────────────\n\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS intent_signals (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n lead_email TEXT NOT NULL,\n lead_name TEXT,\n company TEXT,\n signal_type TEXT NOT NULL,\n signal_source TEXT NOT NULL,\n signal_strength INTEGER DEFAULT 1,\n raw_data TEXT,\n detected_at TEXT DEFAULT (datetime('now')),\n actioned INTEGER DEFAULT 0,\n actioned_at TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_signals_email ON intent_signals(lead_email, detected_at DESC)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_signals_actioned ON intent_signals(actioned, detected_at DESC)`);\n\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS growth_digests (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n week_of TEXT NOT NULL,\n payload TEXT NOT NULL,\n nsm_value_at_generation REAL,\n generated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_digest_week ON growth_digests(week_of DESC)`);\n\n // ─── UNIFIED CALENDAR (CAL1): standalone custom calendar entries ────────────\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS calendar_entries (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n title TEXT NOT NULL,\n description TEXT,\n event_date TEXT NOT NULL,\n event_time TEXT,\n end_date TEXT,\n end_time TEXT,\n event_type TEXT DEFAULT 'custom',\n workspace TEXT DEFAULT 'marketing',\n color TEXT DEFAULT 'blue',\n all_day INTEGER DEFAULT 0,\n recurrence TEXT,\n created_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_calendar_date ON calendar_entries(event_date)`);\n\n // Knowledge files — growth playbooks/frameworks/formulas injected into AI features (see api/knowledge.ts).\n // This table was missing from initDB, so the knowledge UI + /api/knowledge endpoints failed (\"no such table\").\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS knowledge_files (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL,\n kind TEXT DEFAULT 'playbook',\n content TEXT NOT NULL,\n summary TEXT,\n targets TEXT DEFAULT '[]',\n source TEXT DEFAULT 'user',\n tokens_estimate INTEGER DEFAULT 0,\n enabled INTEGER DEFAULT 1,\n uploaded_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_knowledge_enabled ON knowledge_files(enabled, uploaded_at DESC)`);\n\n // Action queue — human-in-the-loop execution. The AI/agents PREPARE external actions\n // (send email, publish post, post to LinkedIn, create calendar event) here; nothing is\n // sent until a human approves, at which point the integration call runs and the result\n // is recorded. status: prepared → approved → executing → done | failed | rejected.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS action_queue (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n source_type TEXT DEFAULT 'chat',\n source_id TEXT,\n integration TEXT NOT NULL,\n endpoint TEXT NOT NULL,\n payload TEXT NOT NULL,\n preview TEXT,\n title TEXT,\n workspace TEXT DEFAULT 'marketing',\n status TEXT DEFAULT 'prepared',\n result TEXT,\n task_id TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n approved_at TEXT,\n executed_at TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_action_queue_status ON action_queue(status, created_at DESC)`);\n\n // CRM: sales pipeline deals. Hybrid model — rows are auto-seeded from qualified leads\n // (getLeadScores) via POST /api/deals/sync AND can be created/edited/dragged by the user.\n // stage ∈ lead | qualified | proposal | negotiation | won | lost. lead_email links a deal back\n // to its source lead so the detail view can show that contact's intent_signals as activity.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS deals (\n id TEXT PRIMARY KEY,\n title TEXT,\n company TEXT,\n contact_name TEXT,\n contact_email TEXT,\n stage TEXT NOT NULL DEFAULT 'lead',\n amount REAL DEFAULT 0,\n currency TEXT DEFAULT 'USD',\n probability INTEGER DEFAULT 0,\n owner TEXT,\n close_date TEXT,\n source TEXT DEFAULT 'manual',\n lead_email TEXT,\n notes TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n last_activity_at TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_deals_stage ON deals(stage, updated_at DESC)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_deals_lead ON deals(lead_email)`);\n\n // ─── RELATIONAL CRM FOUNDATION (WAVE 1): Accounts + Contacts ────────────────\n // First-class company (accounts) and person (contacts) records. Deals link to them via\n // account_id + primary_contact_id, plus a many-to-many deal_contacts join (role per contact).\n // Backfilled NON-DESTRUCTIVELY from the legacy deals.company/contact_name/contact_email text\n // columns by the mig_crm_relational_v1 migration below. All tenant-scoped (tenant_id on every\n // row; every query filters/sets it). The legacy deal text columns are KEPT for back-compat.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS accounts (\n id TEXT PRIMARY KEY,\n name TEXT,\n domain TEXT,\n industry TEXT,\n size TEXT,\n website TEXT,\n owner TEXT,\n tags TEXT DEFAULT '[]',\n custom_fields TEXT DEFAULT '{}',\n notes TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_accounts_name ON accounts(tenant_id, name)`);\n\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS contacts (\n id TEXT PRIMARY KEY,\n account_id TEXT,\n first_name TEXT,\n last_name TEXT,\n email TEXT,\n phone TEXT,\n title TEXT,\n owner TEXT,\n tags TEXT DEFAULT '[]',\n custom_fields TEXT DEFAULT '{}',\n notes TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_contacts_email ON contacts(tenant_id, email)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_contacts_account ON contacts(tenant_id, account_id)`);\n\n // Many-to-many: a deal can involve several contacts, each with a buying-committee role\n // (decision_maker | champion | influencer | user | contact; the migration uses \"primary\"\n // for the deal's primary_contact_id). Composite PK prevents duplicate links.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS deal_contacts (\n deal_id TEXT NOT NULL,\n contact_id TEXT NOT NULL,\n role TEXT DEFAULT 'contact',\n tenant_id TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n PRIMARY KEY (deal_id, contact_id)\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_deal_contacts_contact ON deal_contacts(tenant_id, contact_id)`);\n\n // deals gains account_id + primary_contact_id (guarded ALTER, re-run safe). The legacy\n // company/contact_name/contact_email columns are intentionally KEPT for back-compat.\n try {\n const dc = await sqlite.execute(\"PRAGMA table_info(deals)\");\n const dHave = new Set((dc.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!dHave.has(\"account_id\")) await sqlite.execute(\"ALTER TABLE deals ADD COLUMN account_id TEXT\");\n if (!dHave.has(\"primary_contact_id\")) await sqlite.execute(\"ALTER TABLE deals ADD COLUMN primary_contact_id TEXT\");\n } catch { /* non-critical: relational links added next warm start */ }\n\n // ─── ENGAGEMENT + PIPELINE DEPTH (WAVE 2): Activities + Line Items + Stages ──\n // Unified activity timeline (logged calls/meetings/notes/emails/tasks) attachable to a\n // contact, account, and/or deal. The getTimeline() feed MERGES these rows with intent_signals\n // (by contact email) and linked tasks. All tenant-scoped (tenant_id on every row).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS activities (\n id TEXT PRIMARY KEY,\n type TEXT,\n subject TEXT,\n body TEXT,\n contact_id TEXT,\n account_id TEXT,\n deal_id TEXT,\n owner TEXT,\n due_date TEXT,\n completed INTEGER DEFAULT 0,\n occurred_at TEXT,\n created_at TEXT,\n updated_at TEXT,\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_activities_deal ON activities(tenant_id, deal_id)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_activities_contact ON activities(tenant_id, contact_id)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_activities_account ON activities(tenant_id, account_id)`);\n\n // Deal LINE ITEMS — products/services on a deal. The deal amount rolls up as SUM(amount) when\n // line items exist (else the manual deals.amount is kept). amount is persisted = quantity * unit_price.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS deal_products (\n id TEXT PRIMARY KEY,\n deal_id TEXT,\n name TEXT,\n quantity REAL DEFAULT 1,\n unit_price REAL DEFAULT 0,\n amount REAL DEFAULT 0,\n tenant_id TEXT,\n created_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_deal_products_deal ON deal_products(tenant_id, deal_id)`);\n\n // Configurable PIPELINE STAGES (label + win-probability per stage). Seeded once below with the\n // 6 existing stages so deal stage probabilities/labels become editable per tenant.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS pipeline_stages (\n id TEXT PRIMARY KEY,\n stage_key TEXT,\n label TEXT,\n probability INTEGER,\n sort_order INTEGER,\n is_won INTEGER DEFAULT 0,\n is_lost INTEGER DEFAULT 0,\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_pipeline_stages_tenant ON pipeline_stages(tenant_id, sort_order)`);\n\n // deals gains next_step + win/loss REASONS + recurring/MRR (guarded ALTER, re-run safe).\n try {\n const d2 = await sqlite.execute(\"PRAGMA table_info(deals)\");\n const d2Have = new Set((d2.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n for (const [col, def] of [\n [\"next_step\", \"TEXT\"], [\"win_reason\", \"TEXT\"], [\"lost_reason\", \"TEXT\"],\n [\"recurring_type\", \"TEXT\"], [\"mrr\", \"REAL DEFAULT 0\"],\n ] as Array<[string, string]>) {\n if (!d2Have.has(col)) await sqlite.execute(`ALTER TABLE deals ADD COLUMN ${col} ${def}`);\n }\n } catch { /* non-critical: deal next-step/reasons/MRR added next warm start */ }\n\n // tasks gains CRM links (deal_id / contact_id / account_id) so an existing Task can be a CRM\n // follow-up attached to a deal/contact/account — preserves ALL current task behavior.\n try {\n const t2 = await sqlite.execute(\"PRAGMA table_info(tasks)\");\n const t2Have = new Set((t2.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n for (const col of [\"deal_id\", \"contact_id\", \"account_id\"]) {\n if (!t2Have.has(col)) await sqlite.execute(`ALTER TABLE tasks ADD COLUMN ${col} TEXT`);\n }\n } catch { /* non-critical: CRM task links added next warm start */ }\n\n // ONE-TIME seed of the 6 default pipeline stages, gated by app_config \"mig_pipeline_stages_v1\".\n // Seeds for every tenant that already has pipeline_stages-eligible data (any present tenant_id\n // across tenants) OR at least the default tenant. Idempotent: INSERT OR IGNORE on a deterministic\n // id (tenant + stage_key) + an existence check, so a re-run never duplicates rows.\n try {\n const flag = await sqlite.execute(\"SELECT value FROM app_config WHERE key = 'mig_pipeline_stages_v1'\");\n if (flag.rows.length === 0) {\n const STAGE_SEEDS: Array<[string, string, number, number, number, number]> = [\n // stage_key, label, probability, sort_order, is_won, is_lost\n [\"lead\", \"Lead\", 10, 0, 0, 0],\n [\"qualified\", \"Qualified\", 30, 1, 0, 0],\n [\"proposal\", \"Proposal\", 50, 2, 0, 0],\n [\"negotiation\", \"Negotiation\", 70, 3, 0, 0],\n [\"won\", \"Won\", 100, 4, 1, 0],\n [\"lost\", \"Lost\", 0, 5, 0, 1],\n ];\n // Collect the set of tenants to seed: every distinct tenant on the tenants table, always\n // including t_default. Falls back to just t_default if the tenants table is empty/missing.\n const tenantIds = new Set([\"t_default\"]);\n try {\n const tns = await sqlite.execute(\"SELECT id FROM tenants\");\n for (const r of (tns.rows || [])) {\n const tid = String(Array.isArray(r) ? r[0] : (r as any).id ?? \"\").trim();\n if (tid) tenantIds.add(tid);\n }\n } catch { /* tenants table may not exist on a very fresh DB — default tenant still seeded */ }\n for (const tid of tenantIds) {\n for (const [key, label, prob, sort, isWon, isLost] of STAGE_SEEDS) {\n await sqlite.execute(\n `INSERT OR IGNORE INTO pipeline_stages (id, stage_key, label, probability, sort_order, is_won, is_lost, tenant_id)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,\n [\"ps_\" + tid + \"_\" + key, key, label, prob, sort, isWon, isLost, tid]\n );\n }\n }\n await sqlite.execute(\n \"INSERT OR REPLACE INTO app_config (key, value, tenant_id, updated_at) VALUES ('mig_pipeline_stages_v1', 'done', 't_default', datetime('now'))\"\n );\n }\n } catch { /* non-critical: stage seed retried next warm start (flag only set on success) */ }\n\n // ─── SALES ANALYTICS + LEAD OPS + PRODUCTIVITY (WAVE 3) ─────────────────────\n // Eight new tenant-scoped tables overlaid on the existing deals/contacts/intent_signals/users\n // foundation. All carry tenant_id on every row (every query filters/sets it) and are also added\n // to TENANT_SCOPED_TABLES below so the mig_tenant_v1 backfill covers them on legacy DBs.\n\n // A) SALES ANALYTICS ────────────────────────────────────────────────────────\n // deal_stage_history: one row per deal stage change (deals.ts logs it). Powers stage-conversion,\n // deal-velocity (time in stage), and the funnel/leaderboard analytics.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS deal_stage_history (\n id TEXT PRIMARY KEY,\n deal_id TEXT,\n from_stage TEXT,\n to_stage TEXT,\n owner TEXT,\n changed_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_deal_stage_history_deal ON deal_stage_history(tenant_id, deal_id)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_deal_stage_history_to ON deal_stage_history(tenant_id, to_stage)`);\n\n // sales_quotas: per-owner revenue target for a period. period_type ∈ month|quarter|year; period is\n // the label (e.g. 2026-Q2 or 2026-06). Powers quota-attainment (won vs target).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS sales_quotas (\n id TEXT PRIMARY KEY,\n owner TEXT,\n period TEXT,\n period_type TEXT,\n target_amount REAL DEFAULT 0,\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_sales_quotas_owner ON sales_quotas(tenant_id, owner, period)`);\n\n // pipeline_snapshots: one row PER STAGE per snapshot_date (point-in-time pipeline state). Powers\n // pipeline trend over time. weighted_amount = total_amount × stage probability at capture time.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS pipeline_snapshots (\n id TEXT PRIMARY KEY,\n snapshot_date TEXT,\n stage TEXT,\n deal_count INTEGER DEFAULT 0,\n total_amount REAL DEFAULT 0,\n weighted_amount REAL DEFAULT 0,\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_pipeline_snapshots_date ON pipeline_snapshots(tenant_id, snapshot_date)`);\n\n // B) LEAD OPS ─────────────────────────────────────────────────────────────────\n // lead_status: grade/owner/SLA overlay keyed by lead_email (one row per lead per tenant). grade ∈\n // A|B|C|D; status ∈ new|working|qualified|disqualified. sla_due_at = first-response deadline,\n // first_response_at = when the SLA clock was stopped. Indexed (tenant_id, lead_email) for upsert.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS lead_status (\n id TEXT PRIMARY KEY,\n lead_email TEXT,\n grade TEXT,\n owner TEXT,\n status TEXT DEFAULT 'new',\n first_response_at TEXT,\n sla_due_at TEXT,\n assigned_at TEXT,\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n // UNIQUE so the one-row-per-(tenant,lead) overlay can't be duplicated by a concurrent grade/assign race.\n await sqlite.execute(`CREATE UNIQUE INDEX IF NOT EXISTS idx_lead_status_email ON lead_status(tenant_id, lead_email)`);\n\n // C) PRODUCTIVITY ─────────────────────────────────────────────────────────────\n // email_templates: reusable subject/body with {{merge_field}} placeholders; rendered then handed\n // to the existing Gmail/Outlook draft path.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS email_templates (\n id TEXT PRIMARY KEY,\n name TEXT,\n subject TEXT,\n body TEXT,\n category TEXT,\n owner TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_email_templates_tenant ON email_templates(tenant_id, category)`);\n\n // sequences: a named multi-step cadence (active=1 by default).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS sequences (\n id TEXT PRIMARY KEY,\n name TEXT,\n description TEXT,\n active INTEGER DEFAULT 1,\n created_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_sequences_tenant ON sequences(tenant_id, active)`);\n\n // sequence_steps: ordered steps of a sequence. channel ∈ email|task|call. delay_days = wait after\n // the prior step. template_id optionally references an email_templates row; else inline subject/body.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS sequence_steps (\n id TEXT PRIMARY KEY,\n sequence_id TEXT,\n step_order INTEGER DEFAULT 0,\n channel TEXT DEFAULT 'email',\n delay_days INTEGER DEFAULT 0,\n template_id TEXT,\n subject TEXT,\n body TEXT,\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_sequence_steps_seq ON sequence_steps(tenant_id, sequence_id, step_order)`);\n\n // sequence_enrollments: a contact (and optionally deal) enrolled in a sequence. current_step is the\n // 0-based pointer; status ∈ active|paused|completed; next_action_at drives the cadence runner.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS sequence_enrollments (\n id TEXT PRIMARY KEY,\n sequence_id TEXT,\n contact_id TEXT,\n deal_id TEXT,\n current_step INTEGER DEFAULT 0,\n status TEXT DEFAULT 'active',\n enrolled_at TEXT DEFAULT (datetime('now')),\n next_action_at TEXT,\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_seq_enroll_seq ON sequence_enrollments(tenant_id, sequence_id, status)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_seq_enroll_contact ON sequence_enrollments(tenant_id, contact_id)`);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_seq_enroll_next ON sequence_enrollments(tenant_id, next_action_at)`);\n\n // ─── MARKETING WORKSPACE (WAVE 1) ─────────────────────────────────────────\n // Persona/ICP/segment library for the Marketing Audiences view. kind ∈ icp|persona|segment;\n // attributes is a JSON blob; source ∈ enrichment|manual (importPersonasFromEnrichment writes\n // 'enrichment' rows non-destructively). All tenant-scoped (tenant_id on every row).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS marketing_personas (\n id TEXT PRIMARY KEY,\n name TEXT,\n kind TEXT,\n description TEXT,\n attributes TEXT,\n source TEXT DEFAULT 'manual',\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_marketing_personas_kind ON marketing_personas(tenant_id, kind)`);\n\n // utm_links: saved campaign-tagged URLs for the UTM builder. full_url is the composed\n // base_url + utm params. All tenant-scoped (tenant_id on every row).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS utm_links (\n id TEXT PRIMARY KEY,\n name TEXT,\n base_url TEXT,\n utm_source TEXT,\n utm_medium TEXT,\n utm_campaign TEXT,\n utm_term TEXT,\n utm_content TEXT,\n full_url TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_utm_links_tenant ON utm_links(tenant_id)`);\n\n // brand_kit: one row per tenant (upsert) — voice/tone/values/dos/donts/boilerplate plus a JSON\n // palette and logo_url for the Brand Kit editor. tenant_id on every row.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS brand_kit (\n id TEXT PRIMARY KEY,\n voice TEXT,\n tone TEXT,\n brand_values TEXT,\n dos TEXT,\n donts TEXT,\n boilerplate TEXT,\n palette TEXT,\n logo_url TEXT,\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_brand_kit_tenant ON brand_kit(tenant_id)`);\n\n // ─── MARKETING CAPTURE + AUDIENCES (WAVE 2) ─────────────────────────────────\n // Six new tenant-scoped tables giving Marketing a place to CONVERT traffic (forms +\n // landing pages) and people to TARGET (segments + lists). All carry tenant_id on every\n // row (every query filters/sets it) EXCEPT the two PUBLIC read paths, which resolve the\n // owning tenant explicitly by id/slug. Added to TENANT_SCOPED_TABLES below so the\n // mig_tenant_v1 backfill covers them on legacy DBs. NEVER name a column with a SQL\n // reserved word (e.g. values/order/group) — a prior bug came from exactly that.\n\n // marketing_forms: a lead-capture form definition. fields is JSON [{name,label,type,required}].\n // asset_url = gated lead-magnet download; redirect_url = post-submit redirect. submit_count is\n // bumped on each public submission (by the form-owning tenant).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS marketing_forms (\n id TEXT PRIMARY KEY,\n name TEXT,\n fields TEXT,\n success_message TEXT,\n asset_url TEXT,\n redirect_url TEXT,\n submit_count INTEGER DEFAULT 0,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_marketing_forms_tenant ON marketing_forms(tenant_id)`);\n\n // form_submissions: one row per public submit. data is JSON of the raw posted fields.\n // tenant_id is the OWNING tenant of form_id (resolved by id at submit time — never the\n // anonymous caller's session). Indexed (tenant_id, form_id) for the submissions table.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS form_submissions (\n id TEXT PRIMARY KEY,\n form_id TEXT,\n data TEXT,\n lead_email TEXT,\n lead_name TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_form_submissions_form ON form_submissions(tenant_id, form_id)`);\n\n // landing_pages: a public landing page. slug is GLOBALLY unique (used for the public\n // /api/marketing/p/:slug render across tenants). blocks is JSON [{type,...}]. form_id\n // optionally embeds a marketing_forms form. published=1 gates the public render; view_count\n // is bumped on each public view (by the page-owning tenant).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS landing_pages (\n id TEXT PRIMARY KEY,\n slug TEXT,\n title TEXT,\n subtitle TEXT,\n blocks TEXT,\n form_id TEXT,\n theme TEXT,\n published INTEGER DEFAULT 0,\n view_count INTEGER DEFAULT 0,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_landing_pages_tenant ON landing_pages(tenant_id)`);\n // slug is GLOBALLY unique (public render resolves a page by slug across all tenants).\n await sqlite.execute(`CREATE UNIQUE INDEX IF NOT EXISTS idx_landing_pages_slug ON landing_pages(slug)`);\n\n // segments: a saved audience definition. kind ∈ dynamic|static. rules is JSON\n // [{field,op,value}] evaluated over contacts + lead_status + intent_signals within the tenant.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS segments (\n id TEXT PRIMARY KEY,\n name TEXT,\n description TEXT,\n kind TEXT,\n rules TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_segments_tenant ON segments(tenant_id)`);\n\n // marketing_lists: a named contact list. kind ∈ static|dynamic. For dynamic lists, segment_id\n // references the segment whose rules materialize the membership.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS marketing_lists (\n id TEXT PRIMARY KEY,\n name TEXT,\n kind TEXT,\n segment_id TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_marketing_lists_tenant ON marketing_lists(tenant_id)`);\n\n // list_members: membership join (a contact in a list). lead_email is the stable key when a\n // contact_id is unavailable. Indexed (tenant_id, list_id) for the members view.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS list_members (\n id TEXT PRIMARY KEY,\n list_id TEXT,\n contact_id TEXT,\n lead_email TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n tenant_id TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_list_members_list ON list_members(tenant_id, list_id)`);\n\n // I3: agents.role column for Listener/Topic/Creator/Analyst/General roles (ALTER guarded)\n try {\n const ac = await sqlite.execute(\"PRAGMA table_info(agents)\");\n const aHave = new Set((ac.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!aHave.has(\"role\")) await sqlite.execute(\"ALTER TABLE agents ADD COLUMN role TEXT DEFAULT 'general'\");\n } catch { /* non-critical */ }\n\n // Part 15.3: persistent business memory (evolving learned facts). Additive on v551.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS memory (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n type TEXT DEFAULT 'fact',\n content TEXT NOT NULL,\n source TEXT DEFAULT 'manual',\n confidence REAL DEFAULT 0.7,\n pinned INTEGER DEFAULT 0,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n\n // Part 1: skills (marketing playbooks) STATE table — enabled/pinned + custom skills.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS skills (\n name TEXT PRIMARY KEY,\n enabled INTEGER DEFAULT 1,\n pinned INTEGER DEFAULT 0,\n source TEXT DEFAULT 'builtin',\n category TEXT,\n description TEXT,\n body TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now'))\n )\n `);\n\n // Part 3 fix 7: experiment significance + sample_size (PRAGMA-guarded ALTER).\n try {\n const ec = await sqlite.execute(\"PRAGMA table_info(experiments)\");\n const eHave = new Set((ec.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!eHave.has(\"sample_size\")) await sqlite.execute(\"ALTER TABLE experiments ADD COLUMN sample_size INTEGER\");\n if (!eHave.has(\"significance\")) await sqlite.execute(\"ALTER TABLE experiments ADD COLUMN significance REAL\");\n } catch { /* non-critical */ }\n\n // Part 14.2: agent_runs.trace JSON column (structured TraceStep[]).\n try {\n const rc = await sqlite.execute(\"PRAGMA table_info(agent_runs)\");\n const rHave = new Set((rc.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!rHave.has(\"trace\")) await sqlite.execute(\"ALTER TABLE agent_runs ADD COLUMN trace TEXT\");\n } catch { /* non-critical */ }\n\n // Multi-agent CAMPAIGNS — the higher-level container the user wants: a campaign has many\n // inputs + MANY member agents that cooperate. A campaign RUN is the Director orchestrating\n // its member agents (sequential handoff or parallel) and synthesizing a final output.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS campaigns (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n workspace TEXT NOT NULL DEFAULT 'marketing',\n description TEXT,\n goal TEXT,\n channel TEXT,\n audience TEXT,\n mode TEXT DEFAULT 'sequential',\n status TEXT DEFAULT 'active',\n objective_id INTEGER,\n created_at TEXT DEFAULT (datetime('now')),\n updated_at TEXT DEFAULT (datetime('now')),\n created_by TEXT DEFAULT 'user'\n )\n `);\n // Ordered membership: which agents are in the campaign + their pipeline order + role.\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS campaign_agents (\n campaign_id TEXT NOT NULL,\n agent_id TEXT NOT NULL,\n sequence INTEGER DEFAULT 0,\n role TEXT,\n PRIMARY KEY (campaign_id, agent_id)\n )\n `);\n // One coordinated pipeline execution (the Director run).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS campaign_runs (\n id TEXT PRIMARY KEY,\n campaign_id TEXT NOT NULL,\n status TEXT NOT NULL DEFAULT 'running',\n input TEXT,\n final_output TEXT,\n trace TEXT,\n started_at TEXT DEFAULT (datetime('now')),\n finished_at TEXT\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_campaign_runs ON campaign_runs(campaign_id, started_at DESC)`);\n // Campaign TRIGGERS + LOOP (run continuously, not just on/off). trigger_type: manual | interval\n // | schedule | event. trigger_config: JSON (e.g. {minutes:60} or {event:\"new_lead\"}). loop=1 ⇒\n // reschedule after each run. next_run_at drives the cron-based runner. (Guarded ALTER, re-run safe.)\n try {\n const cc = await sqlite.execute(\"PRAGMA table_info(campaigns)\");\n const cHave = new Set((cc.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n for (const [col, def] of [[\"trigger_type\", \"TEXT DEFAULT 'manual'\"], [\"trigger_config\", \"TEXT\"], [\"next_run_at\", \"TEXT\"], [\"last_run_at\", \"TEXT\"], [\"loop\", \"INTEGER DEFAULT 0\"]] as Array<[string, string]>) {\n if (!cHave.has(col)) await sqlite.execute(`ALTER TABLE campaigns ADD COLUMN ${col} ${def}`);\n }\n } catch { /* non-critical */ }\n // agent_runs gains campaign context: which campaign run + the handed-off context from prior agents.\n try {\n const arc = await sqlite.execute(\"PRAGMA table_info(agent_runs)\");\n const arHave = new Set((arc.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!arHave.has(\"campaign_run_id\")) await sqlite.execute(\"ALTER TABLE agent_runs ADD COLUMN campaign_run_id TEXT\");\n if (!arHave.has(\"received_input\")) await sqlite.execute(\"ALTER TABLE agent_runs ADD COLUMN received_input TEXT\");\n // task_id links an agent_run back to the task it executed (POST /api/tasks/:id/run).\n if (!arHave.has(\"task_id\")) await sqlite.execute(\"ALTER TABLE agent_runs ADD COLUMN task_id TEXT\");\n } catch { /* non-critical */ }\n\n // ─── AUTH / MULTI-TENANCY FOUNDATION ───────────────────────────────────────\n // New auth tables. These have NO tenant_id (they ARE the tenant/identity layer).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS tenants (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n slug TEXT UNIQUE,\n plan TEXT DEFAULT 'trial',\n status TEXT DEFAULT 'active',\n created_at TEXT DEFAULT (datetime('now'))\n )\n `);\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS users (\n id TEXT PRIMARY KEY,\n email TEXT UNIQUE NOT NULL,\n name TEXT,\n password_hash TEXT,\n avatar_url TEXT,\n created_at TEXT DEFAULT (datetime('now')),\n last_login_at TEXT\n )\n `);\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS memberships (\n tenant_id TEXT NOT NULL,\n user_id TEXT NOT NULL,\n role TEXT DEFAULT 'owner',\n created_at TEXT DEFAULT (datetime('now')),\n PRIMARY KEY (tenant_id, user_id)\n )\n `);\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS sessions (\n id TEXT PRIMARY KEY,\n user_id TEXT NOT NULL,\n tenant_id TEXT NOT NULL,\n created_at TEXT DEFAULT (datetime('now')),\n expires_at TEXT,\n user_agent TEXT,\n revoked INTEGER DEFAULT 0\n )\n `);\n await sqlite.execute(`CREATE INDEX IF NOT EXISTS idx_sessions_user ON sessions(user_id)`);\n\n // Phase D: read-only impersonation (\"view as tenant\"). A platform admin toggles this flag on\n // THEIR OWN session row; resolveSessionToken then redirects currentTenantId() to this target\n // tenant for reads only (all writes blocked by the main.ts guard). NULL = not impersonating.\n // PRAGMA-guarded ALTER (idempotent, re-run safe — same pattern as the other ALTERs above).\n try {\n const sc = await sqlite.execute(\"PRAGMA table_info(sessions)\");\n const sHave = new Set((sc.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!sHave.has(\"impersonate_tenant_id\")) await sqlite.execute(\"ALTER TABLE sessions ADD COLUMN impersonate_tenant_id TEXT\");\n } catch { /* non-critical: impersonation disabled until column exists; added next warm start */ }\n\n // ─── PLATFORM SUPERADMIN LAYER (above tenants) ─────────────────────────────\n // The single, audited exception to per-tenant isolation: a platform owner who can read\n // ACROSS all tenants. users gains is_platform_admin (the master flag) + status (active/…).\n // PRAGMA-guarded ALTERs (idempotent, re-run safe — same pattern as the other ALTERs above).\n try {\n const uc = await sqlite.execute(\"PRAGMA table_info(users)\");\n const uHave = new Set((uc.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (!uHave.has(\"is_platform_admin\")) await sqlite.execute(\"ALTER TABLE users ADD COLUMN is_platform_admin INTEGER DEFAULT 0\");\n if (!uHave.has(\"status\")) await sqlite.execute(\"ALTER TABLE users ADD COLUMN status TEXT DEFAULT 'active'\");\n } catch { /* non-critical: master flag set by migration below on next warm start */ }\n\n // platform_audit — append-only log of every master-only action (suspend/delete/impersonate in\n // LATER phases). Created now so the audit surface exists from the start. No tenant_id: it spans\n // all tenants by design (this is the cross-tenant exception).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS platform_audit (\n id TEXT PRIMARY KEY,\n actor_user_id TEXT,\n actor_email TEXT,\n action TEXT,\n target_type TEXT,\n target_id TEXT,\n detail TEXT,\n created_at TEXT DEFAULT (datetime('now'))\n )\n `);\n\n // tenant_id column on EVERY existing business table. PRAGMA-guarded ALTER (idempotent, same\n // pattern used for other ALTERs above). Do NOT add to tenants/users/memberships/sessions.\n const TENANT_SCOPED_TABLES = [\n \"integrations\", \"llm_config\", \"agents\", \"conversations\", \"tasks\", \"tasks_legacy\",\n \"notes\", \"metric_baselines\", \"intelligence_cache\", \"app_config\", \"metric_history\",\n \"agent_budgets\", \"agent_runs\", \"customer_cohorts\", \"lead_state_changes\", \"utm_conversions\",\n \"north_star\", \"nsm_history\", \"objectives\", \"key_results\", \"experiments\", \"intent_signals\",\n \"growth_digests\", \"calendar_entries\", \"knowledge_files\", \"action_queue\", \"deals\", \"memory\",\n \"skills\", \"campaigns\", \"campaign_agents\", \"campaign_runs\",\n \"accounts\", \"contacts\", \"deal_contacts\",\n \"activities\", \"deal_products\", \"pipeline_stages\",\n \"deal_stage_history\", \"sales_quotas\", \"pipeline_snapshots\", \"lead_status\",\n \"email_templates\", \"sequences\", \"sequence_steps\", \"sequence_enrollments\",\n \"marketing_personas\", \"utm_links\", \"brand_kit\",\n \"marketing_forms\", \"form_submissions\", \"landing_pages\",\n \"segments\", \"marketing_lists\", \"list_members\",\n ];\n for (const tbl of TENANT_SCOPED_TABLES) {\n try {\n const cols = await sqlite.execute(`PRAGMA table_info(${tbl})`);\n const have = new Set((cols.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n // Only ALTER if the table actually exists (PRAGMA returns 0 cols for missing tables) and lacks tenant_id.\n if (have.size > 0 && !have.has(\"tenant_id\")) {\n await sqlite.execute(`ALTER TABLE ${tbl} ADD COLUMN tenant_id TEXT`);\n }\n } catch { /* non-critical: table may not exist yet (e.g. tasks_legacy) */ }\n }\n\n // ONE-TIME backfill + seed, gated by app_config \"mig_tenant_v1\" so it runs once. Backfill\n // every business table's tenant_id to \"t_default\" and insert the default tenant row. Owner\n // user creation is left to api/auth.ts bootstrapOwner (no password seeded here).\n try {\n const flag = await sqlite.execute(\"SELECT value FROM app_config WHERE key = 'mig_tenant_v1'\");\n if (flag.rows.length === 0) {\n for (const tbl of TENANT_SCOPED_TABLES) {\n try {\n const cols = await sqlite.execute(`PRAGMA table_info(${tbl})`);\n const have = new Set((cols.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n if (have.has(\"tenant_id\")) {\n await sqlite.execute(`UPDATE ${tbl} SET tenant_id = 't_default' WHERE tenant_id IS NULL`);\n }\n } catch { /* non-critical: skip missing tables */ }\n }\n await sqlite.execute(\n \"INSERT OR IGNORE INTO tenants (id, name, slug) VALUES ('t_default', 'Default Workspace', 'default')\"\n );\n // NOTE: app_config now has tenant_id; write the migration flag scoped to t_default so the\n // gate read above (no tenant filter) still finds it on subsequent boots.\n await sqlite.execute(\n \"INSERT OR REPLACE INTO app_config (key, value, tenant_id, updated_at) VALUES ('mig_tenant_v1', 'done', 't_default', datetime('now'))\"\n );\n }\n } catch { /* non-critical: migration retried next warm start */ }\n\n // ─── PLATFORM MASTER PROMOTION (mig_platform_admin_v1) ──────────────────────\n // ONE-TIME: promote the platform owner (PLATFORM_OWNER_EMAIL env, default the bootstrapped\n // master) to is_platform_admin=1. Gated by app_config \"mig_platform_admin_v1\" so it runs once.\n // api/auth.ts bootstrapOwner ALSO sets the flag at signup time; this covers the already-existing\n // master row. Idempotent: re-running the UPDATE is harmless even if the flag write ever fails.\n try {\n const flag = await sqlite.execute(\"SELECT value FROM app_config WHERE key = 'mig_platform_admin_v1'\");\n if (flag.rows.length === 0) {\n const masterEmail = (Deno.env.get(\"PLATFORM_OWNER_EMAIL\") || \"hoangnh@arrowhitech.com\").trim().toLowerCase();\n await sqlite.execute(\n \"UPDATE users SET is_platform_admin = 1 WHERE lower(email) = ?\",\n [masterEmail]\n );\n await sqlite.execute(\n \"INSERT OR REPLACE INTO app_config (key, value, tenant_id, updated_at) VALUES ('mig_platform_admin_v1', 'done', 't_default', datetime('now'))\"\n );\n }\n } catch { /* non-critical: promotion retried next warm start (flag only set on success) */ }\n\n // ─── INTEGRATIONS UNIQUENESS → PER-TENANT (mig_integrations_v2) ──────────────\n // The original integrations table has `name TEXT NOT NULL UNIQUE` (a GLOBAL unique\n // constraint). Multi-tenant needs each tenant to own its OWN 'google'/'outlook'/etc.\n // row, so uniqueness must be PER TENANT: UNIQUE(tenant_id, name). SQLite cannot ALTER a\n // UNIQUE constraint in place, so we do a ONE-TIME guarded table rebuild gated by an\n // app_config flag (\"mig_integrations_v2\"). Idempotent + safe on the live DB: we only\n // rebuild when the flag is absent AND the live table still carries the global UNIQUE(name)\n // index. By this point Stage 1's ALTER + backfill guarantee every existing integrations\n // row already has tenant_id='t_default', so the copy preserves correct ownership.\n try {\n const flag = await sqlite.execute(\"SELECT value FROM app_config WHERE key = 'mig_integrations_v2'\");\n if (flag.rows.length === 0) {\n // Confirm the table exists before rebuilding. A FRESH DB already gets the per-tenant\n // shape from the top-level CREATE (tenant_id present), so detect the OLD shape — the\n // global UNIQUE(name) index lacks the tenant_id column — and only rebuild then.\n const icols = await sqlite.execute(\"PRAGMA table_info(integrations)\");\n const iHave = new Set((icols.rows || []).map((r: any) => String(Array.isArray(r) ? r[1] : r.name)));\n let needsRebuild = false;\n if (iHave.size > 0) {\n // index_list → for each unique index, index_info tells us its columns. The legacy global\n // constraint indexes only (name); the new one indexes (tenant_id, name).\n try {\n const idxList = await sqlite.execute(\"PRAGMA index_list(integrations)\");\n for (const row of (idxList.rows || [])) {\n const idxName = String(Array.isArray(row) ? row[1] : row.name);\n const idxUnique = Number(Array.isArray(row) ? row[2] : row.unique);\n if (!idxUnique) continue;\n const info = await sqlite.execute(`PRAGMA index_info(${idxName})`);\n const idxCols = (info.rows || []).map((r: any) => String(Array.isArray(r) ? r[2] : r.name));\n // Old-shape: a unique index over exactly [name] with no tenant_id ⇒ rebuild required.\n if (idxCols.includes(\"name\") && !idxCols.includes(\"tenant_id\")) needsRebuild = true;\n }\n } catch { needsRebuild = true; /* if we can't introspect, rebuild to be safe */ }\n }\n if (needsRebuild) {\n // Build v2 with the SAME columns (now including tenant_id) but UNIQUE(tenant_id, name).\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS integrations_v2 (\n id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n api_key TEXT,\n api_secret TEXT,\n access_token TEXT,\n refresh_token TEXT,\n extra_config TEXT,\n connected_at TEXT,\n updated_at TEXT,\n tenant_id TEXT,\n UNIQUE(tenant_id, name)\n )\n `);\n // Copy every row (existing rows already carry tenant_id='t_default' from Stage 1).\n await sqlite.execute(`\n INSERT OR IGNORE INTO integrations_v2\n (id, name, api_key, api_secret, access_token, refresh_token, extra_config, connected_at, updated_at, tenant_id)\n SELECT id, name, api_key, api_secret, access_token, refresh_token, extra_config, connected_at, updated_at,\n COALESCE(tenant_id, 't_default')\n FROM integrations\n `);\n await sqlite.execute(\"DROP TABLE integrations\");\n await sqlite.execute(\"ALTER TABLE integrations_v2 RENAME TO integrations\");\n }\n await sqlite.execute(\n \"INSERT OR REPLACE INTO app_config (key, value, tenant_id, updated_at) VALUES ('mig_integrations_v2', 'done', 't_default', datetime('now'))\"\n );\n }\n } catch { /* non-critical: rebuild retried next warm start (flag only set on success) */ }\n\n // ─── RELATIONAL CRM BACKFILL (mig_crm_relational_v1) ────────────────────────\n // ONE-TIME, gated by app_config \"mig_crm_relational_v1\". For EVERY existing deal, derive the\n // relational records NON-DESTRUCTIVELY from its legacy text fields:\n // • upsert an account by (tenant_id, lower(company)) [skip if company empty]\n // • upsert a contact by (tenant_id, lower(contact_email)) [skip if email empty], name from\n // contact_name, linked to that account\n // • set deal.account_id + deal.primary_contact_id, and insert a deal_contacts(role='primary') row\n // Runs at boot under the default ctx, so it is a GLOBAL pass: it reads each deal's OWN tenant_id\n // and writes the new rows carrying THAT tenant_id (never the boot ctx's). Fully idempotent —\n // existence checks + INSERT OR IGNORE — and never deletes/edits existing deal data.\n try {\n const flag = await sqlite.execute(\"SELECT value FROM app_config WHERE key = 'mig_crm_relational_v1'\");\n if (flag.rows.length === 0) {\n // Pull every deal with its own tenant_id + legacy text fields. SELECT * keeps this robust\n // regardless of column order; we read fields by name from the row object.\n const dealsRes = await sqlite.execute(\n \"SELECT id, tenant_id, company, contact_name, contact_email FROM deals\"\n );\n const dealRows = (dealsRes.rows || []) as any[];\n for (const row of dealRows) {\n // libSQL returns array OR object rows depending on driver — read defensively by index/name.\n const dealId = String(Array.isArray(row) ? row[0] : row.id ?? \"\");\n const tenantId = String((Array.isArray(row) ? row[1] : row.tenant_id) ?? \"t_default\") || \"t_default\";\n const company = String((Array.isArray(row) ? row[2] : row.company) ?? \"\").trim();\n const contactName = String((Array.isArray(row) ? row[3] : row.contact_name) ?? \"\").trim();\n const contactEmail = String((Array.isArray(row) ? row[4] : row.contact_email) ?? \"\").trim();\n if (!dealId) continue;\n\n let accountId: string | null = null;\n let contactId: string | null = null;\n\n // ── ACCOUNT upsert by (tenant_id, lower(company)) ──\n if (company) {\n const existAcct = await sqlite.execute(\n \"SELECT id FROM accounts WHERE tenant_id = ? AND lower(name) = lower(?) LIMIT 1\",\n [tenantId, company]\n );\n if (existAcct.rows.length > 0) {\n const ar = existAcct.rows[0] as any;\n accountId = String(Array.isArray(ar) ? ar[0] : ar.id);\n } else {\n accountId = crypto.randomUUID();\n await sqlite.execute(\n `INSERT INTO accounts (id, name, tags, custom_fields, created_at, updated_at, tenant_id)\n VALUES (?, ?, '[]', '{}', datetime('now'), datetime('now'), ?)`,\n [accountId, company, tenantId]\n );\n }\n }\n\n // ── CONTACT upsert by (tenant_id, lower(contact_email)) ──\n if (contactEmail) {\n const existContact = await sqlite.execute(\n \"SELECT id, account_id FROM contacts WHERE tenant_id = ? AND lower(email) = lower(?) LIMIT 1\",\n [tenantId, contactEmail]\n );\n if (existContact.rows.length > 0) {\n const cr = existContact.rows[0] as any;\n contactId = String(Array.isArray(cr) ? cr[0] : cr.id);\n const existingAcctId = Array.isArray(cr) ? cr[1] : cr.account_id;\n // Backfill the contact's account link if it has none yet and we found one here.\n if (accountId && (existingAcctId === null || existingAcctId === undefined || existingAcctId === \"\")) {\n await sqlite.execute(\n \"UPDATE contacts SET account_id = ?, updated_at = datetime('now') WHERE id = ? AND tenant_id = ?\",\n [accountId, contactId, tenantId]\n );\n }\n } else {\n // Split contact_name into first / last (first token = first name, remainder = last).\n let firstName = \"\", lastName = \"\";\n if (contactName) {\n const parts = contactName.split(/\\s+/);\n firstName = parts.shift() || \"\";\n lastName = parts.join(\" \");\n }\n contactId = crypto.randomUUID();\n await sqlite.execute(\n `INSERT INTO contacts (id, account_id, first_name, last_name, email, tags, custom_fields, created_at, updated_at, tenant_id)\n VALUES (?, ?, ?, ?, ?, '[]', '{}', datetime('now'), datetime('now'), ?)`,\n [contactId, accountId, firstName, lastName, contactEmail, tenantId]\n );\n }\n }\n\n // ── Link the deal: set account_id / primary_contact_id only if still empty (idempotent) ──\n if (accountId || contactId) {\n await sqlite.execute(\n `UPDATE deals\n SET account_id = COALESCE(NULLIF(account_id, ''), ?),\n primary_contact_id = COALESCE(NULLIF(primary_contact_id, ''), ?)\n WHERE id = ? AND tenant_id = ?`,\n [accountId, contactId, dealId, tenantId]\n );\n }\n\n // ── deal_contacts(role='primary') join row (INSERT OR IGNORE on composite PK) ──\n if (contactId) {\n await sqlite.execute(\n `INSERT OR IGNORE INTO deal_contacts (deal_id, contact_id, role, tenant_id, created_at)\n VALUES (?, ?, 'primary', ?, datetime('now'))`,\n [dealId, contactId, tenantId]\n );\n }\n }\n await sqlite.execute(\n \"INSERT OR REPLACE INTO app_config (key, value, tenant_id, updated_at) VALUES ('mig_crm_relational_v1', 'done', 't_default', datetime('now'))\"\n );\n }\n } catch { /* non-critical: relational backfill retried next warm start (flag only set on success) */ }\n\n // Seed default LLM config if not exists\n const existing = await sqlite.execute(\"SELECT id FROM llm_config WHERE id = 'default'\");\n if (existing.rows.length === 0) {\n await sqlite.execute(\n \"INSERT INTO llm_config (id, provider, api_key, model, updated_at) VALUES ('default', 'anthropic', '', 'claude-sonnet-4-6', ?)\",\n [new Date().toISOString()]\n );\n }\n\n // Demo-agent seeding disabled — starting from a clean agents table.\n // Re-enable by uncommenting the call below.\n // await seedDefaultAgents();\n}\n\n// The starter \"demo\" agents seeded on first boot. Exported so the admin \"Remove demo data\"\n// route can identify + remove untouched seed rows (matched by name+description+system_prompt,\n// so a user-renamed/edited agent is never deleted).\nexport const DEFAULT_AGENT_SEEDS = [\n {\n name: \"SEO Analyst\",\n workspace: \"marketing\",\n description: \"Analyzes SEO performance using Ahrefs and Google Search Console data\",\n system_prompt: \"You are an expert SEO analyst. Analyze search performance data, identify opportunities, and provide actionable recommendations to improve organic search rankings.\",\n tools: JSON.stringify([\"ahrefs\", \"gsc\", \"ga4\"]),\n model: \"claude-sonnet-4-6\",\n },\n {\n name: \"Content Creator\",\n workspace: \"marketing\",\n description: \"Creates and manages content for WordPress, YouTube, and social media\",\n system_prompt: \"You are a creative content strategist. Help plan, write, and optimize content for blogs, videos, and social media platforms to drive engagement and conversions.\",\n tools: JSON.stringify([\"wordpress\", \"youtube\", \"ga4\"]),\n model: \"claude-sonnet-4-6\",\n },\n {\n name: \"Analytics Reporter\",\n workspace: \"marketing\",\n description: \"Generates reports from GA4 and Search Console data\",\n system_prompt: \"You are a data analyst specializing in digital marketing analytics. Create insightful reports from GA4 and Search Console data to track KPIs and identify growth opportunities.\",\n tools: JSON.stringify([\"ga4\", \"gsc\", \"ahrefs\"]),\n model: \"claude-sonnet-4-6\",\n },\n {\n name: \"LinkedIn Outreach\",\n workspace: \"sales\",\n description: \"Manages LinkedIn prospecting and connection campaigns\",\n system_prompt: \"You are a sales development expert specializing in LinkedIn outreach. Help craft personalized connection requests, follow-up messages, and engagement strategies to build pipeline.\",\n tools: JSON.stringify([\"linkedin\", \"outlook\"]),\n model: \"claude-sonnet-4-6\",\n },\n {\n name: \"Lead Researcher\",\n workspace: \"sales\",\n description: \"Researches prospects using LinkedIn and web data\",\n system_prompt: \"You are a research specialist who finds and qualifies sales leads. Analyze LinkedIn profiles, company data, and online presence to identify ideal prospects and gather intelligence for sales outreach.\",\n tools: JSON.stringify([\"linkedin\"]),\n model: \"claude-sonnet-4-6\",\n },\n {\n name: \"Email Composer\",\n workspace: \"sales\",\n description: \"Drafts and sends personalized sales emails via Outlook\",\n system_prompt: \"You are a sales email expert who crafts compelling, personalized outreach emails. Write emails that are concise, value-focused, and drive response rates while maintaining brand voice.\",\n tools: JSON.stringify([\"outlook\", \"linkedin\"]),\n model: \"claude-sonnet-4-6\",\n },\n];\n\nasync function seedDefaultAgents() {\n const existing = await sqlite.execute(\"SELECT id FROM agents LIMIT 1\");\n if (existing.rows.length > 0) return;\n\n const now = new Date().toISOString();\n for (const agent of DEFAULT_AGENT_SEEDS) {\n await sqlite.execute(\n `INSERT INTO agents (id, name, workspace, description, system_prompt, tools, model, enabled, created_at, updated_at, created_by)\n VALUES (?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?)`,\n [crypto.randomUUID(), agent.name, agent.workspace, agent.description, agent.system_prompt, agent.tools, agent.model, now, now, \"user\"]\n );\n }\n}\n\n",[441],"cf768a30-5e7b-11f1-a326-1607ee4eb77e","cron_entry.ts","fb10767e-5b1a-11f1-b807-ee650bb23af1",925,["D",1780402127969],"// Scheduled entrypoint — deploy this file as a Val Town INTERVAL/CRON trigger (separate from\n// the HTTP val in main.ts). A single file can't be both the HTTP handler AND the scheduled\n// trigger, which is why the execution engine never ran on its own before: cron.ts had a default\n// export but nothing scheduled it.\n//\n// What it does each tick:\n// 1) processPendingRuns() — runs the LLM tool-loop for any agent_runs with status='pending'\n// (external sends still go to the human-approval action_queue; nothing auto-sends).\n// 2) syncObjectivesFromFunnel() — refreshes + persists KR/objective progress from live funnel\n// data (the GET /api/okrs list no longer writes on read, so this keeps stored progress fresh).\n//\n// Schedule: set the interval in the Val Town dashboard (Triggers → e.g. every 5 minutes).\nimport { initDB } from \"./db.ts\";\nimport { processPendingRuns } from \"./cron.ts\";\nimport { syncObjectivesFromFunnel } from \"./api/okrs.ts\";\nimport { processCampaignTriggers } from \"./api/campaigns.ts\";\n\n// Crash-proof scheduled tick. A single failure (DB 429, a bad run, a flaky integration)\n// must be logged and swallowed so the default export NEVER throws to the Val Town runtime\n// (an uncaught throw kills the tick silently and can disable the trigger). initDB() and each\n// unit of work are guarded INDEPENDENTLY so one failing does not skip the others.\nexport default async function (): Promise {\n // 1) Ensure the DB is ready. If this fails (e.g. DB 429), we cannot safely run the\n // tenant-scoped work below, so log and return — but never throw.\n try {\n await initDB();\n } catch (err) {\n console.error(\"[cron] initDB failed; skipping this tick:\", err);\n return;\n }\n\n // 2) Process pending agent runs (external sends still go to the human-approval queue).\n let runs = { processed: 0, failed: 0 };\n try {\n runs = await processPendingRuns(5);\n } catch (err) {\n console.error(\"[cron] processPendingRuns failed:\", err);\n }\n\n // 3) Fire scheduled/looping campaigns on the cron tick (after agent runs are processed).\n try {\n await processCampaignTriggers(2);\n } catch (err) {\n console.error(\"[cron] processCampaignTriggers failed:\", err);\n }\n\n // 4) Refresh + persist KR/objective progress from live funnel data.\n let okr = { objectives: 0, key_results: 0 };\n try {\n okr = await syncObjectivesFromFunnel();\n } catch (err) {\n console.error(\"[cron] syncObjectivesFromFunnel failed:\", err);\n }\n\n console.log(\n `[cron] runs processed=${runs.processed} failed=${runs.failed}; ` +\n `okr synced objectives=${okr.objectives} key_results=${okr.key_results}`,\n );\n}\n",[449],"cfec26aa-5e7b-11f1-a9e2-1607ee4eb77e","cron.ts","50e655da-5a69-11f1-ab8c-ee650bb23af1",926,["D",1780402128741],"// Execution engine — the missing piece that makes agents actually RUN.\n// Deploy as a val.town interval val (default export runs on a schedule, e.g. every 1–5 min),\n// or trigger manually via POST /api/agents/run-pending (wired in router.ts).\n//\n// It polls agent_runs for status='pending', loads the agent config, and runs an LLM\n// tool-loop reusing chat.ts's buildTools()/executeTool(). External sends still go to the\n// human-approval action_queue (the tools enqueue, they don't send) — so the engine is safe.\nimport { sqlite, tenantStore } from \"./db.ts\";\nimport { getLLMConfig, callLLM } from \"./api/llm.ts\";\nimport { getAgent } from \"./api/agents.ts\";\nimport { buildTools, executeTool } from \"./api/chat.ts\";\nimport { getSkillsIndex } from \"./api/skills.ts\";\nimport { captureMemoryFromConversation } from \"./api/memory.ts\";\nimport { getCompanyContextString } from \"./api/company.ts\";\n\nconst ENGINE_SYSTEM_SUFFIX =\n \"\\n\\nYou can ACT using tools. External sends (email / LinkedIn / WordPress) are QUEUED for human \" +\n \"approval — prepare them and they will appear in Approvals; they will NOT send until a human approves. \" +\n \"Create tasks and schedule calendar events directly. Take the single next-best action toward the goal.\";\n\nexport async function processPendingRuns(limit = 3): Promise<{ processed: number; failed: number }> {\n let processed = 0;\n let failed = 0;\n let rows: any[] = [];\n // Fetch the marketing skills index once per invocation; append to the agent system prompt\n // so the autonomous agent can apply_skill on a match. Empty index = no-op.\n const skillsIdx = await getSkillsIndex({ maxChars: 5000 }).catch(() => \"\");\n const skillsSuffix = skillsIdx\n ? \"\\n\\n\" + skillsIdx + \"\\n\\nWhen a request matches a skill above, call apply_skill with that skill name before acting.\"\n : \"\";\n // Unified business context: prepended to every autonomous agent's system prompt so each run\n // knows the company. Cheap single app_config read; empty string on any error = no-op.\n const companyCtx = await getCompanyContextString(2000).catch(() => \"\");\n try {\n const r = await sqlite.execute(\n \"SELECT id, agent_id, input, tenant_id FROM agent_runs WHERE status = 'pending' ORDER BY started_at ASC LIMIT ?\",\n [limit],\n );\n rows = (r.rows || []) as any[];\n } catch {\n return { processed, failed };\n }\n\n for (const row of rows) {\n const runId = String(row[0]);\n const agentId = String(row[1]);\n const input = row[2] ? String(row[2]) : \"\";\n // MULTI-TENANT CORRECTNESS: cron runs with NO active tenant store, so currentTenantId()\n // would default to t_default and every tenant's pending runs would be processed (and their\n // tool calls / data reads/writes scoped) under t_default. Read THIS row's tenant_id and run\n // the whole processing body inside tenantStore.run so the agent executes in ITS OWN tenant\n // scope. Backfilled/legacy rows with NULL tenant_id fall back to t_default (current behavior).\n const tenantId = row[3] ? String(row[3]) : \"t_default\";\n const ctx = { tenantId, userId: \"system\", email: \"system\", role: \"owner\" as const };\n // Per-run result so the outer counters update after the scoped body returns.\n const r = await tenantStore.run(ctx, async (): Promise<{ ok: boolean }> => {\n // Wrapped so one run's UPDATE failure can't abort the drain.\n try {\n await sqlite.execute(\"UPDATE agent_runs SET status='running' WHERE id=?\", [runId]);\n } catch { /* status flip best-effort; continue processing */ }\n // Part 14.2: structured execution trace (TraceStep[]) — hoisted so a partial trace can be\n // persisted in the catch block on failure. Reset per run.\n const trace: any[] = [];\n try {\n const agent = await getAgent(agentId);\n const llmConfig = await getLLMConfig();\n if (!(llmConfig as any).api_key) throw new Error(\"No LLM API key configured\");\n\n const systemPrompt =\n (companyCtx ? companyCtx + \"\\n\\n---\\n\\n\" : \"\") +\n (agent?.system_prompt || \"You are an autonomous marketing & sales agent.\") + ENGINE_SYSTEM_SUFFIX + skillsSuffix;\n const messages: any[] = [{\n role: \"user\",\n content: input || `Run agent \"${agent?.name || agentId}\". Decide and prepare the next best action toward its goal.`,\n }];\n\n const tools = buildTools();\n let llm = await callLLM(llmConfig, messages, { systemPrompt, tools, maxTokens: 2048 });\n const actionLog: string[] = [];\n let rounds = 0;\n while (llm.tool_calls && llm.tool_calls.length > 0 && rounds < 4) {\n rounds++;\n trace.push({ t: \"round\", n: rounds, ts: new Date().toISOString() });\n messages.push({ role: \"assistant\", content: llm.content || \"\", tool_calls: llm.tool_calls });\n for (const tc of llm.tool_calls) {\n let args: Record = {};\n try {\n args = typeof tc.function.arguments === \"string\"\n ? JSON.parse(tc.function.arguments)\n : (tc.function.arguments || {});\n } catch { args = {}; }\n const toolStart = performance.now();\n const res = await executeTool(tc.function.name, args, llmConfig);\n const ms = Math.round(performance.now() - toolStart);\n actionLog.push(`${tc.function.name}: ${res}`);\n trace.push({\n t: \"tool\",\n name: tc.function.name,\n args_preview: JSON.stringify(args).slice(0, 300),\n result_preview: String(res).slice(0, 300),\n ok: true,\n ms,\n ts: new Date().toISOString(),\n });\n messages.push({ role: \"tool\", tool_call_id: tc.id, content: res });\n }\n llm = await callLLM(llmConfig, messages, { systemPrompt, tools, maxTokens: 2048 });\n }\n\n const output = ((llm.content || \"\") + (actionLog.length ? \"\\n\\n[actions]\\n\" + actionLog.join(\"\\n\") : \"\")).slice(0, 8000);\n trace.push({ t: \"message\", role: \"assistant\", preview: String(output).slice(0, 300), ts: new Date().toISOString() });\n // Per-run status UPDATE in its own try/catch so one failure does not abort the drain.\n try {\n await sqlite.execute(\n \"UPDATE agent_runs SET status='completed', finished_at=datetime('now'), output=?, trace=? WHERE id=?\",\n [output, JSON.stringify(trace), runId],\n );\n } catch { /* completion write best-effort; run already executed */ }\n // Fire-and-forget: distill durable business facts from this completed run into memory.\n captureMemoryFromConversation([\n { role: \"user\", content: messages[0]?.content || input },\n { role: \"assistant\", content: llm.content || output },\n ]).catch(() => {});\n return { ok: true };\n } catch (e: any) {\n // Part 14.2: persist the partial trace captured before the failure.\n await sqlite.execute(\n \"UPDATE agent_runs SET status='failed', finished_at=datetime('now'), error=?, trace=? WHERE id=?\",\n [String(e?.message || e), JSON.stringify(trace), runId],\n ).catch(() => {});\n return { ok: false };\n }\n });\n if (r.ok) processed++; else failed++;\n }\n return { processed, failed };\n}\n\n// val.town interval-val entrypoint.\nexport default async function (): Promise {\n const result = await processPendingRuns(3);\n console.log(`[cron] agent runs processed=${result.processed} failed=${result.failed}`);\n}\n",[456],"eb52f0ae-5d6d-11f1-95b0-1607ee4eb77e","skills","00cb9425-5deb-432c-b10f-0fcd3d61109e",644,["D",1780286210534],"directory",[463],"d0f43d42-5b4e-11f1-8d86-ee650bb23af1","renderers","d81e0fb0-4134-482f-8b60-863ef03f710e",520,["D",1780052949625],[470],"156bfa70-56ca-11f1-8a9a-ee650bb23af1","api","e712dcc1-c69e-4e42-a401-18299fcf7843",["D",1779556136787],[476],"pulls","branches","forks","envVars",{"_487":220,"_489":64},"connections",{"_487":430,"_488":64},"count","unfilledCount","emptyCount",{"_44":475,"_32":476,"_30":477,"_175":-5,"_42":43,"_41":266,"_177":60,"_39":1628,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_643":1629,"_27":1630},{"_44":1623,"_32":1501,"_30":1495,"_175":477,"_42":43,"_41":1624,"_177":60,"_39":1625,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_643":1626,"_27":1627},{"_44":1615,"_32":1616,"_30":1617,"_175":1495,"_42":43,"_41":1618,"_177":60,"_39":1619,"_13":266,"_34":35,"_36":1620,"_24":25,"_181":-5,"_643":1621,"_27":1622},{"_44":1607,"_32":1608,"_30":1609,"_175":1495,"_42":43,"_41":1610,"_177":25,"_39":1611,"_13":179,"_34":35,"_36":1612,"_24":25,"_181":-5,"_643":1613,"_27":1614},{"_44":1600,"_32":1100,"_30":1601,"_175":1495,"_42":43,"_41":1602,"_177":60,"_39":1603,"_13":266,"_34":35,"_36":1604,"_24":25,"_181":-5,"_643":1605,"_27":1606},{"_44":1593,"_32":1092,"_30":1594,"_175":1495,"_42":43,"_41":1595,"_177":60,"_39":1596,"_13":430,"_34":35,"_36":1597,"_24":25,"_181":-5,"_643":1598,"_27":1599},{"_44":1586,"_32":1084,"_30":1587,"_175":1495,"_42":43,"_41":1588,"_177":60,"_39":1589,"_13":303,"_34":35,"_36":1590,"_24":25,"_181":-5,"_643":1591,"_27":1592},{"_44":1579,"_32":1076,"_30":1580,"_175":1495,"_42":43,"_41":1581,"_177":60,"_39":1582,"_13":212,"_34":35,"_36":1583,"_24":25,"_181":-5,"_643":1584,"_27":1585},{"_44":1572,"_32":1068,"_30":1573,"_175":1495,"_42":43,"_41":1574,"_177":60,"_39":1575,"_13":64,"_34":35,"_36":1576,"_24":25,"_181":-5,"_643":1577,"_27":1578},{"_44":1565,"_32":1060,"_30":1566,"_175":1495,"_42":43,"_41":1567,"_177":60,"_39":1568,"_13":204,"_34":35,"_36":1569,"_24":25,"_181":-5,"_643":1570,"_27":1571},{"_44":1558,"_32":1052,"_30":1559,"_175":1495,"_42":43,"_41":1560,"_177":60,"_39":1561,"_13":430,"_34":35,"_36":1562,"_24":25,"_181":-5,"_643":1563,"_27":1564},{"_44":1551,"_32":1044,"_30":1552,"_175":1495,"_42":43,"_41":1553,"_177":60,"_39":1554,"_13":212,"_34":35,"_36":1555,"_24":25,"_181":-5,"_643":1556,"_27":1557},{"_44":1544,"_32":1036,"_30":1545,"_175":1495,"_42":43,"_41":1546,"_177":60,"_39":1547,"_13":258,"_34":35,"_36":1548,"_24":25,"_181":-5,"_643":1549,"_27":1550},{"_44":1537,"_32":1028,"_30":1538,"_175":1495,"_42":43,"_41":1539,"_177":60,"_39":1540,"_13":212,"_34":35,"_36":1541,"_24":25,"_181":-5,"_643":1542,"_27":1543},{"_44":1530,"_32":1020,"_30":1531,"_175":1495,"_42":43,"_41":1532,"_177":60,"_39":1533,"_13":422,"_34":35,"_36":1534,"_24":25,"_181":-5,"_643":1535,"_27":1536},{"_44":1523,"_32":1012,"_30":1524,"_175":1495,"_42":43,"_41":1525,"_177":60,"_39":1526,"_13":64,"_34":35,"_36":1527,"_24":25,"_181":-5,"_643":1528,"_27":1529},{"_44":1516,"_32":1004,"_30":1517,"_175":1495,"_42":43,"_41":1518,"_177":60,"_39":1519,"_13":64,"_34":35,"_36":1520,"_24":25,"_181":-5,"_643":1521,"_27":1522},{"_44":1509,"_32":996,"_30":1510,"_175":1495,"_42":43,"_41":1511,"_177":60,"_39":1512,"_13":64,"_34":35,"_36":1513,"_24":25,"_181":-5,"_643":1514,"_27":1515},{"_44":1502,"_32":988,"_30":1503,"_175":1495,"_42":43,"_41":1504,"_177":60,"_39":1505,"_13":303,"_34":35,"_36":1506,"_24":25,"_181":-5,"_643":1507,"_27":1508},{"_44":1493,"_32":980,"_30":1494,"_175":1495,"_42":43,"_41":1496,"_177":25,"_39":1497,"_13":303,"_34":35,"_36":1498,"_24":25,"_181":-5,"_643":1499,"_27":1500},{"_44":1485,"_32":1486,"_30":1487,"_175":477,"_42":43,"_41":1488,"_177":60,"_39":1489,"_13":64,"_34":35,"_36":1490,"_24":25,"_181":-5,"_643":1491,"_27":1492},{"_44":1477,"_32":1478,"_30":1479,"_175":477,"_42":43,"_41":1480,"_177":60,"_39":1481,"_13":303,"_34":35,"_36":1482,"_24":25,"_181":-5,"_643":1483,"_27":1484},{"_44":1469,"_32":1470,"_30":1471,"_175":477,"_42":43,"_41":1472,"_177":60,"_39":1473,"_13":64,"_34":35,"_36":1474,"_24":25,"_181":-5,"_643":1475,"_27":1476},{"_44":1461,"_32":1462,"_30":1463,"_175":477,"_42":43,"_41":1464,"_177":60,"_39":1465,"_13":1319,"_34":35,"_36":1466,"_24":25,"_181":-5,"_643":1467,"_27":1468},{"_44":1453,"_32":1454,"_30":1455,"_175":477,"_42":43,"_41":1456,"_177":60,"_39":1457,"_13":422,"_34":35,"_36":1458,"_24":25,"_181":-5,"_643":1459,"_27":1460},{"_44":1445,"_32":1446,"_30":1447,"_175":477,"_42":43,"_41":1448,"_177":60,"_39":1449,"_13":64,"_34":35,"_36":1450,"_24":25,"_181":-5,"_643":1451,"_27":1452},{"_44":1437,"_32":1438,"_30":1439,"_175":477,"_42":43,"_41":1440,"_177":25,"_39":1441,"_13":303,"_34":35,"_36":1442,"_24":25,"_181":-5,"_643":1443,"_27":1444},{"_44":1429,"_32":1430,"_30":1431,"_175":477,"_42":43,"_41":1432,"_177":60,"_39":1433,"_13":204,"_34":35,"_36":1434,"_24":25,"_181":-5,"_643":1435,"_27":1436},{"_44":1421,"_32":1422,"_30":1423,"_175":477,"_42":43,"_41":1424,"_177":60,"_39":1425,"_13":422,"_34":35,"_36":1426,"_24":25,"_181":-5,"_643":1427,"_27":1428},{"_44":1412,"_32":1413,"_30":1414,"_175":477,"_42":43,"_41":1415,"_177":25,"_39":1416,"_13":1417,"_34":35,"_36":1418,"_24":25,"_181":-5,"_643":1419,"_27":1420},{"_44":1404,"_32":1405,"_30":1406,"_175":477,"_42":43,"_41":1407,"_177":25,"_39":1408,"_13":430,"_34":35,"_36":1409,"_24":25,"_181":-5,"_643":1410,"_27":1411},{"_44":1396,"_32":1397,"_30":1398,"_175":477,"_42":43,"_41":1399,"_177":25,"_39":1400,"_13":430,"_34":35,"_36":1401,"_24":25,"_181":-5,"_643":1402,"_27":1403},{"_44":1388,"_32":1389,"_30":1390,"_175":477,"_42":43,"_41":1391,"_177":60,"_39":1392,"_13":64,"_34":35,"_36":1393,"_24":25,"_181":-5,"_643":1394,"_27":1395},{"_44":1380,"_32":1381,"_30":1382,"_175":477,"_42":43,"_41":1383,"_177":60,"_39":1384,"_13":303,"_34":35,"_36":1385,"_24":25,"_181":-5,"_643":1386,"_27":1387},{"_44":1372,"_32":1373,"_30":1374,"_175":477,"_42":43,"_41":1375,"_177":25,"_39":1376,"_13":422,"_34":35,"_36":1377,"_24":25,"_181":-5,"_643":1378,"_27":1379},{"_44":1364,"_32":1365,"_30":1366,"_175":477,"_42":43,"_41":1367,"_177":60,"_39":1368,"_13":64,"_34":35,"_36":1369,"_24":25,"_181":-5,"_643":1370,"_27":1371},{"_44":1356,"_32":1357,"_30":1358,"_175":477,"_42":43,"_41":1359,"_177":60,"_39":1360,"_13":220,"_34":35,"_36":1361,"_24":25,"_181":-5,"_643":1362,"_27":1363},{"_44":1348,"_32":1349,"_30":1350,"_175":477,"_42":43,"_41":1351,"_177":60,"_39":1352,"_13":250,"_34":35,"_36":1353,"_24":25,"_181":-5,"_643":1354,"_27":1355},{"_44":1340,"_32":1341,"_30":1342,"_175":477,"_42":43,"_41":1343,"_177":25,"_39":1344,"_13":64,"_34":35,"_36":1345,"_24":25,"_181":-5,"_643":1346,"_27":1347},{"_44":1332,"_32":1333,"_30":1334,"_175":477,"_42":43,"_41":1335,"_177":60,"_39":1336,"_13":64,"_34":35,"_36":1337,"_24":25,"_181":-5,"_643":1338,"_27":1339},{"_44":1323,"_32":1324,"_30":1325,"_175":477,"_42":43,"_41":1326,"_177":25,"_39":1327,"_13":1328,"_34":35,"_36":1329,"_24":25,"_181":-5,"_643":1330,"_27":1331},{"_44":1314,"_32":1315,"_30":1316,"_175":477,"_42":43,"_41":1317,"_177":25,"_39":1318,"_13":1319,"_34":35,"_36":1320,"_24":25,"_181":-5,"_643":1321,"_27":1322},{"_44":1306,"_32":1307,"_30":1308,"_175":477,"_42":43,"_41":1309,"_177":60,"_39":1310,"_13":204,"_34":35,"_36":1311,"_24":25,"_181":-5,"_643":1312,"_27":1313},{"_44":1298,"_32":1299,"_30":1300,"_175":477,"_42":43,"_41":1301,"_177":25,"_39":1302,"_13":64,"_34":35,"_36":1303,"_24":25,"_181":-5,"_643":1304,"_27":1305},{"_44":1290,"_32":1291,"_30":1292,"_175":477,"_42":43,"_41":1293,"_177":25,"_39":1294,"_13":64,"_34":35,"_36":1295,"_24":25,"_181":-5,"_643":1296,"_27":1297},{"_44":1282,"_32":1283,"_30":1284,"_175":477,"_42":43,"_41":1285,"_177":60,"_39":1286,"_13":64,"_34":35,"_36":1287,"_24":25,"_181":-5,"_643":1288,"_27":1289},{"_44":1273,"_32":1274,"_30":1275,"_175":477,"_42":43,"_41":1276,"_177":25,"_39":1277,"_13":1278,"_34":35,"_36":1279,"_24":25,"_181":-5,"_643":1280,"_27":1281},{"_44":1269,"_32":33,"_30":31,"_175":477,"_42":43,"_41":14,"_177":60,"_39":1270,"_13":266,"_34":35,"_36":38,"_24":25,"_181":-5,"_643":1271,"_27":1272},{"_44":1261,"_32":1262,"_30":1263,"_175":477,"_42":43,"_41":1264,"_177":25,"_39":1265,"_13":64,"_34":35,"_36":1266,"_24":25,"_181":-5,"_643":1267,"_27":1268},{"_44":1253,"_32":1254,"_30":1255,"_175":477,"_42":43,"_41":1256,"_177":60,"_39":1257,"_13":430,"_34":35,"_36":1258,"_24":25,"_181":-5,"_643":1259,"_27":1260},{"_44":1245,"_32":1246,"_30":1247,"_175":477,"_42":43,"_41":1248,"_177":60,"_39":1249,"_13":430,"_34":35,"_36":1250,"_24":25,"_181":-5,"_643":1251,"_27":1252},{"_44":1237,"_32":1238,"_30":1239,"_175":477,"_42":43,"_41":1240,"_177":25,"_39":1241,"_13":430,"_34":35,"_36":1242,"_24":25,"_181":-5,"_643":1243,"_27":1244},{"_44":1229,"_32":1230,"_30":1231,"_175":477,"_42":43,"_41":1232,"_177":25,"_39":1233,"_13":422,"_34":35,"_36":1234,"_24":25,"_181":-5,"_643":1235,"_27":1236},{"_44":1221,"_32":1222,"_30":1223,"_175":477,"_42":43,"_41":1224,"_177":25,"_39":1225,"_13":64,"_34":35,"_36":1226,"_24":25,"_181":-5,"_643":1227,"_27":1228},{"_44":1213,"_32":1214,"_30":1215,"_175":477,"_42":43,"_41":1216,"_177":60,"_39":1217,"_13":414,"_34":35,"_36":1218,"_24":25,"_181":-5,"_643":1219,"_27":1220},{"_44":1205,"_32":1206,"_30":1207,"_175":477,"_42":43,"_41":1208,"_177":60,"_39":1209,"_13":64,"_34":35,"_36":1210,"_24":25,"_181":-5,"_643":1211,"_27":1212},{"_44":1197,"_32":1198,"_30":1199,"_175":477,"_42":43,"_41":1200,"_177":60,"_39":1201,"_13":266,"_34":35,"_36":1202,"_24":25,"_181":-5,"_643":1203,"_27":1204},{"_44":1189,"_32":1190,"_30":1191,"_175":477,"_42":43,"_41":1192,"_177":60,"_39":1193,"_13":204,"_34":35,"_36":1194,"_24":25,"_181":-5,"_643":1195,"_27":1196},{"_44":1181,"_32":1182,"_30":1183,"_175":477,"_42":43,"_41":1184,"_177":60,"_39":1185,"_13":64,"_34":35,"_36":1186,"_24":25,"_181":-5,"_643":1187,"_27":1188},{"_44":1173,"_32":1174,"_30":1175,"_175":477,"_42":43,"_41":1176,"_177":60,"_39":1177,"_13":64,"_34":35,"_36":1178,"_24":25,"_181":-5,"_643":1179,"_27":1180},{"_44":1165,"_32":1166,"_30":1167,"_175":477,"_42":43,"_41":1168,"_177":60,"_39":1169,"_13":204,"_34":35,"_36":1170,"_24":25,"_181":-5,"_643":1171,"_27":1172},{"_44":1157,"_32":1158,"_30":1159,"_175":477,"_42":43,"_41":1160,"_177":60,"_39":1161,"_13":430,"_34":35,"_36":1162,"_24":25,"_181":-5,"_643":1163,"_27":1164},{"_44":1149,"_32":1150,"_30":1151,"_175":477,"_42":43,"_41":1152,"_177":60,"_39":1153,"_13":64,"_34":35,"_36":1154,"_24":25,"_181":-5,"_643":1155,"_27":1156},{"_44":1141,"_32":1142,"_30":1143,"_175":477,"_42":43,"_41":1144,"_177":60,"_39":1145,"_13":64,"_34":35,"_36":1146,"_24":25,"_181":-5,"_643":1147,"_27":1148},{"_44":1133,"_32":1134,"_30":1135,"_175":477,"_42":43,"_41":1136,"_177":60,"_39":1137,"_13":242,"_34":35,"_36":1138,"_24":25,"_181":-5,"_643":1139,"_27":1140},{"_44":1125,"_32":1126,"_30":1127,"_175":477,"_42":43,"_41":1128,"_177":60,"_39":1129,"_13":64,"_34":35,"_36":1130,"_24":25,"_181":-5,"_643":1131,"_27":1132},{"_44":1117,"_32":1118,"_30":1119,"_175":477,"_42":43,"_41":1120,"_177":60,"_39":1121,"_13":220,"_34":35,"_36":1122,"_24":25,"_181":-5,"_643":1123,"_27":1124},{"_44":469,"_32":470,"_30":471,"_175":-5,"_42":43,"_41":472,"_177":60,"_39":1114,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_643":1115,"_27":1116},{"_44":1107,"_32":1108,"_30":1109,"_175":471,"_42":43,"_41":472,"_177":60,"_39":1110,"_13":64,"_34":35,"_36":1111,"_24":25,"_181":-5,"_643":1112,"_27":1113},{"_44":1099,"_32":1100,"_30":1101,"_175":471,"_42":43,"_41":1102,"_177":60,"_39":1103,"_13":64,"_34":35,"_36":1104,"_24":25,"_181":-5,"_643":1105,"_27":1106},{"_44":1091,"_32":1092,"_30":1093,"_175":471,"_42":43,"_41":1094,"_177":60,"_39":1095,"_13":64,"_34":35,"_36":1096,"_24":25,"_181":-5,"_643":1097,"_27":1098},{"_44":1083,"_32":1084,"_30":1085,"_175":471,"_42":43,"_41":1086,"_177":60,"_39":1087,"_13":430,"_34":35,"_36":1088,"_24":25,"_181":-5,"_643":1089,"_27":1090},{"_44":1075,"_32":1076,"_30":1077,"_175":471,"_42":43,"_41":1078,"_177":60,"_39":1079,"_13":64,"_34":35,"_36":1080,"_24":25,"_181":-5,"_643":1081,"_27":1082},{"_44":1067,"_32":1068,"_30":1069,"_175":471,"_42":43,"_41":1070,"_177":60,"_39":1071,"_13":64,"_34":35,"_36":1072,"_24":25,"_181":-5,"_643":1073,"_27":1074},{"_44":1059,"_32":1060,"_30":1061,"_175":471,"_42":43,"_41":1062,"_177":60,"_39":1063,"_13":266,"_34":35,"_36":1064,"_24":25,"_181":-5,"_643":1065,"_27":1066},{"_44":1051,"_32":1052,"_30":1053,"_175":471,"_42":43,"_41":1054,"_177":60,"_39":1055,"_13":64,"_34":35,"_36":1056,"_24":25,"_181":-5,"_643":1057,"_27":1058},{"_44":1043,"_32":1044,"_30":1045,"_175":471,"_42":43,"_41":1046,"_177":60,"_39":1047,"_13":430,"_34":35,"_36":1048,"_24":25,"_181":-5,"_643":1049,"_27":1050},{"_44":1035,"_32":1036,"_30":1037,"_175":471,"_42":43,"_41":1038,"_177":60,"_39":1039,"_13":64,"_34":35,"_36":1040,"_24":25,"_181":-5,"_643":1041,"_27":1042},{"_44":1027,"_32":1028,"_30":1029,"_175":471,"_42":43,"_41":1030,"_177":60,"_39":1031,"_13":64,"_34":35,"_36":1032,"_24":25,"_181":-5,"_643":1033,"_27":1034},{"_44":1019,"_32":1020,"_30":1021,"_175":471,"_42":43,"_41":1022,"_177":60,"_39":1023,"_13":64,"_34":35,"_36":1024,"_24":25,"_181":-5,"_643":1025,"_27":1026},{"_44":1011,"_32":1012,"_30":1013,"_175":471,"_42":43,"_41":1014,"_177":60,"_39":1015,"_13":64,"_34":35,"_36":1016,"_24":25,"_181":-5,"_643":1017,"_27":1018},{"_44":1003,"_32":1004,"_30":1005,"_175":471,"_42":43,"_41":1006,"_177":60,"_39":1007,"_13":430,"_34":35,"_36":1008,"_24":25,"_181":-5,"_643":1009,"_27":1010},{"_44":995,"_32":996,"_30":997,"_175":471,"_42":43,"_41":998,"_177":60,"_39":999,"_13":64,"_34":35,"_36":1000,"_24":25,"_181":-5,"_643":1001,"_27":1002},{"_44":987,"_32":988,"_30":989,"_175":471,"_42":43,"_41":990,"_177":60,"_39":991,"_13":64,"_34":35,"_36":992,"_24":25,"_181":-5,"_643":993,"_27":994},{"_44":979,"_32":980,"_30":981,"_175":471,"_42":43,"_41":982,"_177":60,"_39":983,"_13":266,"_34":35,"_36":984,"_24":25,"_181":-5,"_643":985,"_27":986},{"_44":462,"_32":463,"_30":464,"_175":-5,"_42":43,"_41":465,"_177":60,"_39":976,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_643":977,"_27":978},{"_44":972,"_32":908,"_30":902,"_175":464,"_42":43,"_41":465,"_177":60,"_39":973,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_643":974,"_27":975},{"_44":965,"_32":966,"_30":967,"_175":902,"_42":43,"_41":465,"_177":60,"_39":968,"_13":64,"_34":35,"_36":969,"_24":25,"_181":-5,"_643":970,"_27":971},{"_44":957,"_32":958,"_30":959,"_175":902,"_42":43,"_41":960,"_177":60,"_39":961,"_13":64,"_34":35,"_36":962,"_24":25,"_181":-5,"_643":963,"_27":964},{"_44":949,"_32":950,"_30":951,"_175":902,"_42":43,"_41":952,"_177":60,"_39":953,"_13":64,"_34":35,"_36":954,"_24":25,"_181":-5,"_643":955,"_27":956},{"_44":941,"_32":942,"_30":943,"_175":902,"_42":43,"_41":944,"_177":60,"_39":945,"_13":64,"_34":35,"_36":946,"_24":25,"_181":-5,"_643":947,"_27":948},{"_44":933,"_32":934,"_30":935,"_175":902,"_42":43,"_41":936,"_177":60,"_39":937,"_13":64,"_34":35,"_36":938,"_24":25,"_181":-5,"_643":939,"_27":940},{"_44":925,"_32":926,"_30":927,"_175":902,"_42":43,"_41":928,"_177":60,"_39":929,"_13":64,"_34":35,"_36":930,"_24":25,"_181":-5,"_643":931,"_27":932},{"_44":917,"_32":918,"_30":919,"_175":902,"_42":43,"_41":920,"_177":60,"_39":921,"_13":64,"_34":35,"_36":922,"_24":25,"_181":-5,"_643":923,"_27":924},{"_44":909,"_32":910,"_30":911,"_175":902,"_42":43,"_41":912,"_177":60,"_39":913,"_13":64,"_34":35,"_36":914,"_24":25,"_181":-5,"_643":915,"_27":916},{"_44":899,"_32":900,"_30":901,"_175":902,"_42":43,"_41":903,"_177":60,"_39":904,"_13":64,"_34":35,"_36":905,"_24":25,"_181":-5,"_643":906,"_27":907},{"_44":895,"_32":774,"_30":768,"_175":464,"_42":43,"_41":890,"_177":60,"_39":896,"_13":64,"_34":467,"_36":-5,"_24":25,"_181":-5,"_643":897,"_27":898},{"_44":887,"_32":888,"_30":889,"_175":768,"_42":43,"_41":890,"_177":60,"_39":891,"_13":64,"_34":35,"_36":892,"_24":25,"_181":-5,"_643":893,"_27":894},{"_44":879,"_32":880,"_30":881,"_175":768,"_42":43,"_41":882,"_177":60,"_39":883,"_13":64,"_34":35,"_36":884,"_24":25,"_181":-5,"_643":885,"_27":886},{"_44":871,"_32":872,"_30":873,"_175":768,"_42":43,"_41":874,"_177":60,"_39":875,"_13":64,"_34":35,"_36":876,"_24":25,"_181":-5,"_643":877,"_27":878},{"_44":863,"_32":864,"_30":865,"_175":768,"_42":43,"_41":866,"_177":60,"_39":867,"_13":64,"_34":35,"_36":868,"_24":25,"_181":-5,"_643":869,"_27":870},{"_44":855,"_32":856,"_30":857,"_175":768,"_42":43,"_41":858,"_177":60,"_39":859,"_13":64,"_34":35,"_36":860,"_24":25,"_181":-5,"_643":861,"_27":862},{"_44":847,"_32":848,"_30":849,"_175":768,"_42":43,"_41":850,"_177":60,"_39":851,"_13":64,"_34":35,"_36":852,"_24":25,"_181":-5,"_643":853,"_27":854},{"_44":839,"_32":840,"_30":841,"_175":768,"_42":43,"_41":842,"_177":60,"_39":843,"_13":64,"_34":35,"_36":844,"_24":25,"_181":-5,"_643":845,"_27":846},{"_44":831,"_32":832,"_30":833,"_175":768,"_42":43,"_41":834,"_177":60,"_39":835,"_13":64,"_34":35,"_36":836,"_24":25,"_181":-5,"_643":837,"_27":838},{"_44":823,"_32":824,"_30":825,"_175":768,"_42":43,"_41":826,"_177":60,"_39":827,"_13":64,"_34":35,"_36":828,"_24":25,"_181":-5,"_643":829,"_27":830},{"_44":815,"_32":816,"_30":817,"_175":768,"_42":43,"_41":818,"_177":60,"_39":819,"_13":64,"_34":35,"_36":820,"_24":25,"_181":-5,"_643":821,"_27":822},{"_44":807,"_32":808,"_30":809,"_175":768,"_42":43,"_41":810,"_177":60,"_39":811,"_13":64,"_34":35,"_36":812,"_24":25,"_181":-5,"_643":813,"_27":814},{"_44":799,"_32":800,"_30":801,"_175":768,"_42":43,"_41":802,"_177":60,"_39":803,"_13":64,"_34":35,"_36":804,"_24":25,"_181":-5,"_643":805,"_27":806},{"_44":791,"_32":792,"_30":793,"_175":768,"_42":43,"_41":794,"_177":60,"_39":795,"_13":64,"_34":35,"_36":796,"_24":25,"_181":-5,"_643":797,"_27":798},{"_44":783,"_32":784,"_30":785,"_175":768,"_42":43,"_41":786,"_177":60,"_39":787,"_13":64,"_34":35,"_36":788,"_24":25,"_181":-5,"_643":789,"_27":790},{"_44":775,"_32":776,"_30":777,"_175":768,"_42":43,"_41":778,"_177":60,"_39":779,"_13":64,"_34":35,"_36":780,"_24":25,"_181":-5,"_643":781,"_27":782},{"_44":765,"_32":766,"_30":767,"_175":768,"_42":43,"_41":769,"_177":60,"_39":770,"_13":64,"_34":35,"_36":771,"_24":25,"_181":-5,"_643":772,"_27":773},{"_44":757,"_32":758,"_30":759,"_175":464,"_42":43,"_41":760,"_177":60,"_39":761,"_13":64,"_34":35,"_36":762,"_24":25,"_181":-5,"_643":763,"_27":764},{"_44":455,"_32":456,"_30":457,"_175":-5,"_42":43,"_41":458,"_177":25,"_39":754,"_13":204,"_34":35,"_36":460,"_24":25,"_181":-5,"_643":755,"_27":756},{"_44":448,"_32":449,"_30":450,"_175":-5,"_42":43,"_41":451,"_177":60,"_39":751,"_13":266,"_34":35,"_36":453,"_24":25,"_181":-5,"_643":752,"_27":753},{"_44":440,"_32":441,"_30":442,"_175":-5,"_42":43,"_41":443,"_177":25,"_39":748,"_13":445,"_34":35,"_36":446,"_24":25,"_181":-5,"_643":749,"_27":750},{"_44":433,"_32":434,"_30":435,"_175":-5,"_42":43,"_41":436,"_177":25,"_39":745,"_13":195,"_34":35,"_36":438,"_24":25,"_181":-5,"_643":746,"_27":747},{"_44":425,"_32":426,"_30":427,"_175":-5,"_42":43,"_41":428,"_177":60,"_39":742,"_13":430,"_34":35,"_36":431,"_24":25,"_181":-5,"_643":743,"_27":744},{"_44":417,"_32":418,"_30":419,"_175":-5,"_42":43,"_41":420,"_177":60,"_39":739,"_13":422,"_34":35,"_36":423,"_24":25,"_181":-5,"_643":740,"_27":741},{"_44":409,"_32":410,"_30":411,"_175":-5,"_42":43,"_41":412,"_177":60,"_39":736,"_13":414,"_34":35,"_36":415,"_24":25,"_181":-5,"_643":737,"_27":738},{"_44":402,"_32":403,"_30":404,"_175":-5,"_42":43,"_41":405,"_177":60,"_39":733,"_13":242,"_34":35,"_36":407,"_24":25,"_181":-5,"_643":734,"_27":735},{"_44":394,"_32":395,"_30":396,"_175":-5,"_42":43,"_41":397,"_177":60,"_39":730,"_13":399,"_34":35,"_36":400,"_24":25,"_181":-5,"_643":731,"_27":732},{"_44":387,"_32":388,"_30":389,"_175":-5,"_42":43,"_41":390,"_177":60,"_39":727,"_13":204,"_34":35,"_36":392,"_24":25,"_181":-5,"_643":728,"_27":729},{"_44":380,"_32":381,"_30":382,"_175":-5,"_42":43,"_41":383,"_177":60,"_39":724,"_13":64,"_34":35,"_36":385,"_24":25,"_181":-5,"_643":725,"_27":726},{"_44":373,"_32":374,"_30":375,"_175":-5,"_42":43,"_41":376,"_177":60,"_39":721,"_13":303,"_34":35,"_36":378,"_24":25,"_181":-5,"_643":722,"_27":723},{"_44":366,"_32":367,"_30":368,"_175":-5,"_42":43,"_41":369,"_177":60,"_39":718,"_13":204,"_34":35,"_36":371,"_24":25,"_181":-5,"_643":719,"_27":720},{"_44":358,"_32":359,"_30":360,"_175":-5,"_42":43,"_41":361,"_177":25,"_39":715,"_13":363,"_34":35,"_36":364,"_24":25,"_181":-5,"_643":716,"_27":717},{"_44":350,"_32":351,"_30":352,"_175":-5,"_42":43,"_41":353,"_177":25,"_39":712,"_13":355,"_34":35,"_36":356,"_24":25,"_181":-5,"_643":713,"_27":714},{"_44":343,"_32":344,"_30":345,"_175":-5,"_42":43,"_41":346,"_177":60,"_39":709,"_13":311,"_34":35,"_36":348,"_24":25,"_181":-5,"_643":710,"_27":711},{"_44":336,"_32":337,"_30":338,"_175":-5,"_42":43,"_41":339,"_177":25,"_39":706,"_13":64,"_34":35,"_36":341,"_24":25,"_181":-5,"_643":707,"_27":708},{"_44":329,"_32":330,"_30":331,"_175":-5,"_42":43,"_41":332,"_177":60,"_39":703,"_13":303,"_34":35,"_36":334,"_24":25,"_181":-5,"_643":704,"_27":705},{"_44":321,"_32":322,"_30":323,"_175":-5,"_42":43,"_41":324,"_177":25,"_39":700,"_13":326,"_34":35,"_36":327,"_24":25,"_181":-5,"_643":701,"_27":702},{"_44":314,"_32":315,"_30":316,"_175":-5,"_42":43,"_41":317,"_177":60,"_39":697,"_13":266,"_34":35,"_36":319,"_24":25,"_181":-5,"_643":698,"_27":699},{"_44":306,"_32":307,"_30":308,"_175":-5,"_42":43,"_41":309,"_177":60,"_39":694,"_13":311,"_34":35,"_36":312,"_24":25,"_181":-5,"_643":695,"_27":696},{"_44":298,"_32":299,"_30":300,"_175":-5,"_42":43,"_41":301,"_177":60,"_39":691,"_13":303,"_34":35,"_36":304,"_24":25,"_181":-5,"_643":692,"_27":693},{"_44":290,"_32":291,"_30":292,"_175":-5,"_42":43,"_41":293,"_177":25,"_39":688,"_13":295,"_34":35,"_36":296,"_24":25,"_181":-5,"_643":689,"_27":690},{"_44":283,"_32":284,"_30":285,"_175":-5,"_42":43,"_41":286,"_177":60,"_39":685,"_13":266,"_34":35,"_36":288,"_24":25,"_181":-5,"_643":686,"_27":687},{"_44":276,"_32":277,"_30":278,"_175":-5,"_42":43,"_41":279,"_177":60,"_39":682,"_13":220,"_34":35,"_36":281,"_24":25,"_181":-5,"_643":683,"_27":684},{"_44":269,"_32":270,"_30":271,"_175":-5,"_42":43,"_41":272,"_177":60,"_39":679,"_13":204,"_34":35,"_36":274,"_24":25,"_181":-5,"_643":680,"_27":681},{"_44":261,"_32":262,"_30":263,"_175":-5,"_42":43,"_41":264,"_177":60,"_39":676,"_13":266,"_34":35,"_36":267,"_24":25,"_181":-5,"_643":677,"_27":678},{"_44":253,"_32":254,"_30":255,"_175":-5,"_42":43,"_41":256,"_177":60,"_39":673,"_13":258,"_34":35,"_36":259,"_24":25,"_181":-5,"_643":674,"_27":675},{"_44":245,"_32":246,"_30":247,"_175":-5,"_42":43,"_41":248,"_177":60,"_39":670,"_13":250,"_34":35,"_36":251,"_24":25,"_181":-5,"_643":671,"_27":672},{"_44":237,"_32":238,"_30":239,"_175":-5,"_42":43,"_41":240,"_177":60,"_39":667,"_13":242,"_34":35,"_36":243,"_24":25,"_181":-5,"_643":668,"_27":669},{"_44":230,"_32":231,"_30":232,"_175":-5,"_42":43,"_41":233,"_177":60,"_39":664,"_13":64,"_34":35,"_36":235,"_24":25,"_181":-5,"_643":665,"_27":666},{"_44":223,"_32":224,"_30":225,"_175":-5,"_42":43,"_41":226,"_177":60,"_39":661,"_13":64,"_34":35,"_36":228,"_24":25,"_181":-5,"_643":662,"_27":663},{"_44":215,"_32":216,"_30":217,"_175":-5,"_42":43,"_41":218,"_177":60,"_39":658,"_13":220,"_34":35,"_36":221,"_24":25,"_181":-5,"_643":659,"_27":660},{"_44":207,"_32":208,"_30":209,"_175":-5,"_42":43,"_41":210,"_177":60,"_39":655,"_13":212,"_34":35,"_36":213,"_24":25,"_181":-5,"_643":656,"_27":657},{"_44":199,"_32":200,"_30":201,"_175":-5,"_42":43,"_41":202,"_177":60,"_39":652,"_13":204,"_34":35,"_36":205,"_24":25,"_181":-5,"_643":653,"_27":654},{"_44":191,"_32":192,"_30":58,"_175":-5,"_42":43,"_41":193,"_177":25,"_39":649,"_13":195,"_34":196,"_36":197,"_24":25,"_181":-5,"_643":650,"_27":651},{"_44":183,"_32":184,"_30":185,"_175":-5,"_42":43,"_41":186,"_177":25,"_39":646,"_13":188,"_34":35,"_36":189,"_24":25,"_181":-5,"_643":647,"_27":648},{"_44":172,"_32":173,"_30":174,"_175":-5,"_42":43,"_41":176,"_177":60,"_39":642,"_13":179,"_34":35,"_36":180,"_24":25,"_181":-5,"_643":644,"_27":645},["D",1780291403301],"children",[],[173],["D",1780465411894],[],[184],["D",1780455958842],[],[192],["D",1780393062576],[],[200],["D",1780372195351],[],[208],["D",1780372198155],[],[216],["D",1780403524788],[],[224],["D",1780403526320],[],[231],["D",1780403527651],[],[238],["D",1780393064155],[],[246],["D",1780393049485],[],[254],["D",1780029981482],[],[262],["D",1779775316358],[],[270],["D",1780402139102],[],[277],["D",1780402136705],[],[284],["D",1780393058305],[],[291],["D",1780052948479],[],[299],["D",1780052947805],[],[307],["D",1780455959852],[],[315],["D",1780465409612],[],[322],["D",1780030685043],[],[330],["D",1780465408647],[],[337],["D",1780402137967],[],[344],["D",1780455960768],[],[351],["D",1780465410611],[],[359],["D",1780305934253],[],[367],["D",1780402134889],[],[374],["D",1780462244747],[],[381],["D",1780462245605],[],[388],["D",1780393054688],[],[395],["D",1780393060117],[],[403],["D",1780393047117],[],[410],["D",1780053308385],[],[418],["D",1780305932286],[],[426],["D",1780310003617],[],[434],["D",1780467931614],[],[441],["D",1780402127969],[],[449],["D",1780402128741],[],[456],"ffa758d8-5d6d-11f1-97cc-1607ee4eb77e","index.ts","ffa75996-5d6d-11f1-97cc-1607ee4eb77e",669,["D",1780286244707],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\n// Bundled marketing-skills catalog (43 skills, 97 references),\n// read from memory like the renderers/ assembly. State (enabled/pinned/custom) lives in the\n// 'skills' DB table; this module is the immutable builtin content.\nimport { SKILLS_PART_1 } from \"./catalog/part_1.ts\";\nimport { SKILLS_PART_2 } from \"./catalog/part_2.ts\";\nimport { SKILLS_PART_3 } from \"./catalog/part_3.ts\";\nimport { SKILLS_PART_4 } from \"./catalog/part_4.ts\";\nimport { SKILLS_PART_5 } from \"./catalog/part_5.ts\";\nimport { SKILLS_PART_6 } from \"./catalog/part_6.ts\";\nimport { SKILLS_PART_7 } from \"./catalog/part_7.ts\";\nimport { SKILLS_PART_8 } from \"./catalog/part_8.ts\";\nimport { SKILLS_PART_9 } from \"./catalog/part_9.ts\";\nimport { REFS_PART_1 } from \"./refs/ref_1.ts\";\nimport { REFS_PART_2 } from \"./refs/ref_2.ts\";\nimport { REFS_PART_3 } from \"./refs/ref_3.ts\";\nimport { REFS_PART_4 } from \"./refs/ref_4.ts\";\nimport { REFS_PART_5 } from \"./refs/ref_5.ts\";\nimport { REFS_PART_6 } from \"./refs/ref_6.ts\";\nimport { REFS_PART_7 } from \"./refs/ref_7.ts\";\nimport { REFS_PART_8 } from \"./refs/ref_8.ts\";\nimport { REFS_PART_9 } from \"./refs/ref_9.ts\";\nimport { REFS_PART_10 } from \"./refs/ref_10.ts\";\nimport { REFS_PART_11 } from \"./refs/ref_11.ts\";\nimport { REFS_PART_12 } from \"./refs/ref_12.ts\";\nimport { REFS_PART_13 } from \"./refs/ref_13.ts\";\nimport { REFS_PART_14 } from \"./refs/ref_14.ts\";\nimport { REFS_PART_15 } from \"./refs/ref_15.ts\";\nimport { REFS_PART_16 } from \"./refs/ref_16.ts\";\n\nexport interface SkillDef { name: string; category: string; description: string; version: string; body: string }\nexport interface SkillRef { skill: string; ref: string; body: string }\n\nexport const BUILTIN_SKILLS: SkillDef[] = [...SKILLS_PART_1, ...SKILLS_PART_2, ...SKILLS_PART_3, ...SKILLS_PART_4, ...SKILLS_PART_5, ...SKILLS_PART_6, ...SKILLS_PART_7, ...SKILLS_PART_8, ...SKILLS_PART_9];\nconst REFS: SkillRef[] = [...REFS_PART_1, ...REFS_PART_2, ...REFS_PART_3, ...REFS_PART_4, ...REFS_PART_5, ...REFS_PART_6, ...REFS_PART_7, ...REFS_PART_8, ...REFS_PART_9, ...REFS_PART_10, ...REFS_PART_11, ...REFS_PART_12, ...REFS_PART_13, ...REFS_PART_14, ...REFS_PART_15, ...REFS_PART_16];\n\nconst BY_NAME = new Map(BUILTIN_SKILLS.map((s) => [s.name, s]));\n\nexport function getSkillDef(name: string): SkillDef | undefined { return BY_NAME.get(name); }\nexport function getSkillBody(name: string): string | null { return BY_NAME.get(name)?.body ?? null; }\nexport function listReferences(name: string): string[] { return REFS.filter((r) => r.skill === name).map((r) => r.ref); }\nexport function getReference(name: string, ref: string): string | null {\n const hit = REFS.find((r) => r.skill === name && r.ref === ref);\n return hit ? hit.body : null;\n}\n",[],[463,758],"ff025a0e-5d6d-11f1-b895-1607ee4eb77e","ref_9.ts","ff025aea-5d6d-11f1-b895-1607ee4eb77e","c9768083-9936-4697-a4d4-80b7978fe701",668,["D",1780286243627],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_9: SkillRef[] = [\n {\"skill\":\"marketing-plan\",\"ref\":\"example-quietude\",\"body\":\"# Example — Quietude Marketing Plan v1\\n\\n**This is the canonical reference example for the `/marketing-plan` skill.** It's based on a real fCMO engagement for a hybrid hardware-and-software wellness platform. **Names, domains, and identifying details have been changed** — the client is called \\\"Quietude\\\" here, and the team members have been renamed (Alex / Sam / Casey / Devon). The funnel numbers, budget, and structural lessons preserve the shape of the original engagement so the example retains its teaching value.\\n\\nUse this as the \\\"what good looks like\\\" reference when drafting a new plan. The structure, tone, depth, and operational specificity are the bar to clear.\\n\\n**Quietude's archetype:** Hybrid hardware + software with deep-tech / clinical credibility layer. See `references/client-types.md` for archetype patterns.\\n\\n**Funding-stage context:** Pre-seed-close (mid-raise on $3M seed). Tier 1 per `references/funding-stage-unlocks.md`. $0 paid budget; organic + lifecycle + ambassador only.\\n\\n**What was strong about this plan:**\\n- Strategic frame (Section 2) leaned on the founder's own meditation-vs-regulation framing as the content pillar\\n- Current state (Section 3) included the 17-section audit rubric scored against existing materials (no formal audit run)\\n- 90-day roadmap (Section 9) had owner-assigned moves, not just actions\\n- Ops stack (Section 11) included a concrete operational proof-point (Customer.io MCP used live by non-technical founder on the kickoff call)\\n- Tactical idea bank (Section 12) cross-referenced all 139 marketing-ideas to AARRR + Quietude-specific status, including 23 explicit skips with rationale\\n\\n---\\n\\n# Quietude — Marketing Plan v1\\n\\n**Prepared by:** Casey Reed (fCMO)\\n**For:** Alex, Sam, and the Quietude team\\n**Date:** 2026-05-27\\n**Status:** Draft v1 — for team review\\n\\n## 1. Executive summary\\n\\nQuietude has built something rare: a clinically validated, brand-coherent, founder-led product in a category that doesn't yet have a name. The opportunity in the next twelve months is not to invent a marketing engine from scratch — it's to **convert the existing organic gravity into a measurable, repeatable funnel**, then layer paid acquisition on top of that funnel once the seed round closes.\\n\\n**Three big bets, ranked by leverage:**\\n\\n1. **Fix the leak before pouring water in.** The Day 1 → Day 35 funnel shape (1.34% → 5.46%) tells us the product converts given time and contact. What it's missing is a working first-session moment (the headphone gate is killing conversion) and a lifecycle layer to deliver the contact. These two pieces — onboarding rebuild and Customer.io flows shipped — are the unlock for everything else.\\n2. **Compound the moats Quietude already has.** Peer-reviewed clinical study, longevity-influencer PR, 15K live event participants, Alex's founder voice — these are link generators, content pillars, and credibility anchors that most wellness brands would kill for. They're under-leveraged. SEO, content, and App Store optimization translate them into search and discovery surface area.\\n3. **Build the founder-and-fCMO operating system that lets a 4-person team market like a 20-person one.** This is what makes the plan actually executable at Quietude's team size and burn rate — agentic tooling on top of Customer.io, Shopify, App Store, Stripe, GitHub, and the marketing skill library means we ship without hiring.\\n\\n**What twelve months looks like, plausibly:**\\n\\n- App goes from beta to GA. Onboarding converts at meaningful lift over today's baseline.\\n- 4 SEO content pillars staked, with Pillar 1 (Nervous System Regulation) and Pillar 2 (Sleep + Eye Mask) ranking on Tier-1 keywords.\\n- Full lifecycle live in Customer.io: onboarding, lapsed re-engagement, hardware post-purchase, subscription-center opt-ins.\\n- Ambassador program live with 15–25 active hosts. First Quietude Guides cert pilot run.\\n- Eye mask wedge selling at scale via Shopify with a clean hardware → app activation path. Blended CAC measured and tracked.\\n- Paid acquisition firing post-seed-close at $5–10K/mo initial test budget, scaling to $20–50K/mo if unit economics validate.\\n- Series A narrative writes itself: clinical evidence + activation lift + lifecycle compounding + first B2B install reference cases.\\n\\n**The 90-day priorities** (which the rest of this doc operationalizes):\\n\\n1. Kill the headphones gate. Ship the bedrock fix this week.\\n2. Run the three-variant onboarding test. Find the activation winner.\\n3. Ship Customer.io Flows 6 (eye mask post-purchase) and 4 (lapsed user) — hold Flow 2 (onboarding) until app UI stabilizes.\\n4. Rewrite the App Store listing in Quietude's brand voice. Highest-leverage non-site asset right now.\\n5. Stake the SEO foundation: consolidate to `quietude.app`, publish Pillar 1 hub + 3 spokes, publish the peer-reviewed psychophysiology study landing page.\\n6. Launch the ambassador program with the ~5 inbound waiting.\\n\\nEverything else compounds on top of those six.\\n\\n---\\n\\n## 2. Strategic frame\\n\\nThis section distills positioning, ICP, and brand voice into what the team needs to keep in mind while executing. Full detail lives in `marketing-os.md`, `icp.md`, and `sound-philosophy.md`.\\n\\n### What Quietude is, in one sentence\\n\\nA nervous system intelligence platform — clinically validated spatial audio + AI reflection companion (Mira) + hardware + venue installations + practitioner network. *\\\"We start with sound. We expand to every sense. We end with cities.\\\"*\\n\\n### The category we're claiming (and defending)\\n\\nQuietude doesn't fit the meditation app category, the focus audio category, or the sleep tech category. The brand makes a stronger claim: **bottom-up nervous system regulation through spatial audio**, with clinical evidence as proof and somatic credibility as defense.\\n\\nThe category-defining frame, per Alex (2026-05-19): **Meditation is top-down. Quietude is bottom-up.** Meditation uses the mind to command the body — mental kung fu that fails the very people most likely to need help, because the prefrontal cortex is offline when stressed. Quietude enters through the brainstem, before the thinking mind. The body responds before it has to try. (Full content-pillar treatment in `meditation-vs-regulation.md`.)\\n\\nThis is the single most important strategic message. It belongs in App Store copy, onboarding, lifecycle email, SEO content, ambassador talking points, and the seed deck.\\n\\n### Who we're for (D2C ICP, distilled)\\n\\nOverstimulated high-achieving professionals, 25–45, urban (Bay Area, NYC, London, Berlin, Austin). Tech workers, founders, creators, academics, designers, consultants. Often neurodivergent (ADHD, HSP, gifted). Sophisticated wellness buyers — already invested heavily in their inner life.\\n\\n**Their stated problem:** *\\\"I can't shut my brain off. I've tried meditation apps. They don't work.\\\"*\\n\\n**Their real problem:** Overstimulation, not under-motivation. Their gift (quick thinking) became a curse. They need permission to stop optimizing — including their rest.\\n\\n**What they're actually buying:** the *feeling* of stability, sensory indulgence, beautiful rituals, effortless effectiveness, a luxurious shortcut to the genius they can't access in chaos.\\n\\n### The business model logic (per seed deck)\\n\\n**B2B seeds the market. D2C harvests.** A venue install puts Quietude in front of ~20K people/year at ~$17K cost → 5% convert to subs → ~$430K/year per venue. Six compound channels (referral, Guides, content, home hosting, PR, community) make CAC approach zero by Year 3. Year 5: 75% of new subs come from near-zero-cost channels.\\n\\n**fCMO scope per kickoff: D2C-led.** Alex owns B2B sales through events/network/founder credibility. The fCMO leverage is on the app/hardware D2C side. This plan reflects that split — B2B is acknowledged as the harvest engine but not treated as primary work surface.\\n\\n### Brand voice (the non-negotiable)\\n\\nPer Marketing OS:\\n- **Tone.** Authoritative yet accessible. Intimate yet professional. Revolutionary yet grounded. Authority comes from lived experience, not explanation.\\n- **Speak from the body, not the mind.** Every sentence restores somatic safety and orientation. Language opens space rather than closing meaning.\\n- **YES vocabulary:** Aliveness, inner life, nervous system, spatial sound, resonance, somatic safety, embodied clarity, natural rhythm, orientation, initiation, truth-telling.\\n- **NO vocabulary:** Zen, chill, vibes, \\\"high-vibe,\\\" spiritual bypass, meditation clichés, didactic/explainer language, \\\"let me explain why this works.\\\"\\n- **Core method: Initiatory Reflection.** Writing's purpose isn't to explain or convince — it's to shift the reader's internal state. The result should be *\\\"something in me moved,\\\"* not *\\\"I understand this concept.\\\"*\\n- **CTA rule:** Never pressure. \\\"We do not remind. We invite.\\\"\\n\\nThis rule constrains every piece of copy across every AARRR stage. When in doubt: rewrite from the body.\\n\\n---\\n\\n## 3. Current state\\n\\nThis is what we're starting from — team, budget, what's already in motion, what's stuck, scored against the CF Marketing Audit 17-section rubric.\\n\\n### Team composition (marketing surface area)\\n\\n| Person | Role | Marketing surface area |\\n|---|---|---|\\n| **Alex** | Co-founder, CEO | Owns: personal LinkedIn, live events, B2B sales, founder narrative, investor relations, brand voice authorship |\\n| **Sam** | Co-founder, CXO | Owns: clinical/somatic credibility, brand-voice stewardship, somatic angle on copy review, practitioner network |\\n| **Devon** | Lead Dev | Owns: product/UI build, instrumentation, Customer.io event wiring, App Store deployment |\\n| **Ed Dorsey** | Design Advisor | Advisory cadence (ex-Apple/Airbnb/Strava) |\\n| **Emily Babich** | Creative Strategy | Advisory cadence |\\n| **Matt Mikkelsen** | Field Recording | Audio library, not marketing |\\n| **Casey Reed** | fCMO | Strategy, lifecycle, SEO, onboarding tests, content, ambassador program, ops stack |\\n\\n**No dedicated marketing hire yet.** First hire likely post-seed close (Q3 2026 candidate): a lifecycle + content marketing manager who owns Customer.io, SEO content production, and ambassador operations day-to-day.\\n\\n### Marketing budget (current)\\n\\n- **Paid acquisition:** $0. Confirmed by Alex, 2026-05-20: *\\\"D2C UA so far: My personal LinkedIn posts, live Quietude events, organic word of mouth, and organic app store discovery.\\\"* No paid layer.\\n- **Tooling stack:** Customer.io subscription, Shopify (eye mask storefront), App Store Connect, GA4 (or pending), Stripe, Notion, Dub.co (ambassador attribution). Estimate ~$500–1,500/mo combined.\\n- **fCMO retainer:** Casey Reed engagement.\\n- **PR:** No paid PR. Organic longevity-influencer tailwind, consumer-tech angels + foundation-model lab network.\\n\\n**Implication:** The 90-day plan must produce gains without any paid lever pulled. Everything in the next 12 weeks is organic, lifecycle, or product-level. Paid is a Q2–Q3 unlock.\\n\\n### What's already done (acknowledge, then build on)\\n\\n| Asset | Status | Marketing leverage |\\n|---|---|---|\\n| Peer-reviewed peer-reviewed psychophysiology study (2025) | Published | Anchor of clinical authority. Most undermarketed asset Quietude owns. |\\n| longevity-influencer eye-mask endorsement | Live, generating Shopify sales | Press hook. Underused for landing-page social proof. |\\n| consumer-tech angels + foundation-model lab investment | Closed | Investor PR opportunity. \\\"Why I invested\\\" Substack/Medium pieces. |\\n| 15K+ live event participants over a decade | Real | Email list potential, ambassador pool, testimonial bank, B2B reference. |\\n| Quietude eye mask (5K in stock) | Selling | The wedge product. Hardware → app activation path. |\\n| 38% 12-month retention (vs. category avg 20%) | Real | Headline metric. Belongs everywhere. |\\n| Customer.io + Shopify integration | Wired | The lifecycle infrastructure exists. Flows just need to ship. |\\n| 4 GitHub repos for context + product | Set up | `quietude-context` (shared brain), `quietude-promo`, `quietude-app` (app), `mira` (AI), `quietude-api` |\\n| Alex's Sound Philosophy doc | Working doc | Linkable position paper once polished and published. |\\n| ~5 inbound ambassadors waiting | Inbound | Referral program ready to launch — no demand-gen needed for v1. |\\n| Aurora B2B install (~€250K, July deadline) | In-flight | First flagship venue. Reference case once installed. |\\n| Notion Knowledge Directory | Live | Internal context. |\\n| Customer.io MCP (Claude integration) | Validated on kickoff | Non-technical team can ship flows independently. |\\n\\n### What's in-flight (drafted but not shipped)\\n\\n| Item | Status | Blocker |\\n|---|---|---|\\n| Flow 2 — App Onboarding (8 emails / 14 days) | Draft | App UI in flux; copy references screens that may change |\\n| Flow 4 — Lapsed User Re-engagement (5 emails / 38 days) | Draft | None — ship-ready |\\n| Flow 6 — Eye Mask Post-Purchase | Draft | None — ship-ready |\\n| Onboarding rebuild (3-variant test plan) | Strategy doc done | Eng scoping + headphone-gate removal |\\n| SEO 90-day plan + keyword research | Done | Awaiting domain consolidation decision + content production start |\\n\\n### What's stuck (and needs to unstick this quarter)\\n\\n| Issue | Cost of inaction | Action |\\n|---|---|---|\\n| Headphones hard-gate in onboarding | Confirmed conversion drop post-launch | Kill this week (bedrock fix) |\\n| 4 domains unconsolidated (quietude.app, quietude.space, quietude.audio, quietude.center) | SEO authority fragmenting, transactional email confusion | Consolidate to `quietude.app` per SEO data |\\n| App Store listing copy not in brand voice | Highest-traffic Quietude surface; off-brand experience for arriving users | Rewrite in voice (Pillar 1) |\\n| Domain consolidation requires 301 plan + email sender migration | Risk of traffic loss if mishandled | Plan in weeks 1–2, execute weeks 3–4 |\\n| `quietude-promo` repo hasn't shipped since March 2026 | Marketing site is stale | Confirm whether it's live; rewrite or replace |\\n| 29% monthly App Store churn vs. 38% 12-month retention claim | Metric definition mismatch confusing the team | Reconcile with Devon + Customer.io data |\\n| Mira post-session reflection scope unknown | Blocks Variant B and Variant C onboarding tests | Resolve with Devon |\\n\\n### Audit rubric snapshot (17-section)\\n\\nScored 0–5 from materials, using the embedded rubric in `references/current-state-rubric.md`. Marked \\\"scored from materials\\\" rather than \\\"formal audit\\\" — Alex can push back on any score where they have better data.\\n\\n| # | Section | Score | Note |\\n|---|---|---|---|\\n| 1 | Positioning | **4** | Clear, original category claim. The bottom-up frame is the strongest piece. Needs broader external articulation. |\\n| 2 | Customer research | **4** | Deep founder-led research, decade of live participants. Could be more systematically captured. |\\n| 3 | Homepage | **2** | `quietude-promo` hasn't shipped since March. Off-brand voice in places. |\\n| 4 | Sales / product pages | **2** | Eye mask page exists on Shopify but isn't optimized for SEO or sales narrative. No app-product landing page in brand voice. |\\n| 5 | Conversion pages | **2** | `/partner` exists on `quietude.app`. No `/science`, `/eye-mask`, `/ambassadors`, `/guides` pages live. |\\n| 6 | Competitor comparison | **1** | Nothing exists. Big SEO + sales opportunity (own \\\"Quietude vs. Calm/Headspace/Brain.fm/Endel\\\" SERPs). |\\n| 7 | Resources / content | **1** | Sound Philosophy not yet public. peer-reviewed psychophysiology study not yet on a dedicated page. No blog. |\\n| 8 | Onboarding | **2** | Headphones gate killing conversion. Hold-and-fix project this quarter. |\\n| 9 | Email lifecycle | **1** | All three flows drafted, none live. Ship-order set. |\\n| 10 | Sales material | **3** | Seed deck is strong (investor-facing). B2B sales material more founder-led than asset-led. |\\n| 11 | Messaging | **5** | Alex + Sam have authored the most distinctive brand voice in the wellness category. This is a moat. |\\n| 12 | Pricing | **3** | $30/mo app, $45 eye mask, $7,500 speakers, $50–200K B2B. Hasn't been pressure-tested for D2C conversion lift. |\\n| 13 | CRO | **2** | App Store conversion rate trackable but no A/B history. Headphones gate is the obvious first test removal. |\\n| 14 | GTM / launches | **2** | App in throttled beta. Major launches (eye mask, Mira public) haven't had structured GTM. |\\n| 15 | Ads | **0** | No paid layer. Reflects the current organic strategy — not a weakness, but the budget unlock means this will move. |\\n| 16 | SEO | **1** | Current state: 7 organic visits/mo. Plan exists; execution not yet started. |\\n| 17 | Internationalization | **1** | Finland HQ + global ICP, but EN-only and US-centric copy. Defer until Q4+. |\\n\\n**Total: 36 / 85 (42%).** The shape matters more than the score: high in Positioning + Messaging + Customer research, low in Conversion pages + Email lifecycle + SEO + Resources + Ads. That's the gap this plan closes.\\n\\n---\\n\\n## 4. Acquisition\\n\\n> *\\\"How do strangers become aware of Quietude?\\\"*\\n\\n### Current state\\n\\n100% organic. Four real channels: Alex's personal LinkedIn, live Quietude events, organic word of mouth, organic App Store discovery. Plus passive PR drag from longevity-influencer endorsement + clinical study.\\n\\nThis is good news, not bad. Every dollar of revenue earned to date has been earned without paid acquisition. The bar to exceed it isn't high; the upside on top of an organic base is significant.\\n\\n### The plan\\n\\n**Channel 1 — SEO (primary 90-day investment).**\\nThe full 90-day plan lives in `seo/plan.md`. Summary: consolidate to `quietude.app`, target three asymmetric clusters (nervous-system regulation KD 14–32, weighted/blackout sleep mask KD 6–30, WELL + social-wellness-club B2B KD 5–34), publish 4 content pillars. 90-day target: 500–1,500 organic visits/mo, 80+ ranking keywords. 12-month target: 10,000/mo, 1,000+ keywords.\\n\\n**Channel 2 — App Store optimization (highest-leverage non-site asset).**\\nThe App Store listing is currently the most-visited Quietude URL by Apple's algorithm. Fixing the copy is higher-leverage this quarter than fixing the marketing site. Rewrite in brand voice. Add the meditation-vs-regulation framing. Lead with the clinical anchor. Test screenshot variations.\\n\\n**Channel 3 — Alex's LinkedIn (productize the channel).**\\nToday it's ad-hoc founder posting. The next move is structured: a 2–3x/week cadence, post categories that map to the content pillars (nervous system, sound science, founder journey, clinical evidence, behind-the-scenes), trackable links via Dub, follower → email subscriber → app install funnel measured. This is Alex's voice — the channel only works if he's the one writing. fCMO + Typefully scheduling makes the cadence sustainable.\\n\\n**Channel 4 — PR amplification.**\\nlongevity-influencer tailwind is real but underused on owned surfaces. Add a `/notable-users` or `/in-the-press` page. Pitch the peer-reviewed psychophysiology study to 5 outlets (wellness press: Well+Good, MindBodyGreen; tech-adjacent: Wired with the longevity-influencer hook; mainstream: Outside, Forbes Wellness). HARO/Help-A-B2B-Writer responses citing Quietude's data. Investor PR moments (\\\"Why I invested in Quietude\\\" Substack pieces from consumer-tech angels — push for these with backlinks).\\n\\n**Channel 5 — Event-to-app instrumentation.**\\nLive events are the highest-converting ICP exposure Quietude has (15K+ participants, decade of trust). They're un-instrumented. Add: per-event QR code → app install + email capture, post-event lifecycle (Customer.io Flow 7?), event ROI tracking. Goal: turn an event from a one-night conversion moment into a 30-day funnel.\\n\\n**Channel 6 — Eye mask wedge (consumer entry product).**\\n5K masks in stock. Shopify storefront exists but isn't optimized. Improvements: SEO-optimize the product page (target \\\"weighted sleep mask,\\\" \\\"blackout sleep mask,\\\" \\\"silk sleep mask\\\"), add reviews via Judge.me (per kickoff decision), 30-day return policy (US-market expectation, per kickoff), build the listicle (\\\"Quietude vs. Manta vs. Nodpod vs. Lumon\\\"). Consider Amazon listing as a v2 distribution play.\\n\\n**Channel 7 — B2B venue installs (kept lean per kickoff).**\\nAlex owns this. Marketing supports with: case studies after each install, `/partner` page rewrite in voice (already exists on quietude.app), Pillar 4 content (\\\"The Missing Sound Feature in WELL\\\"), reciprocal links from partner venues baked into contracts.\\n\\n**Channel 8 — Paid layer (unlocked post-seed close).**\\nHeld until seed funding lands. Initial test budget: $5–10K/mo split across Apple Search Ads (highest-intent for App Store), Meta (Instagram + Facebook for eye mask), LinkedIn (B2B venue buyers). Don't fire until: (a) onboarding bedrock fix is shipped, (b) Flow 6 is live, (c) at least one Pillar landing page is in voice. Paid amplifies what already works — premature paid amplifies what's broken.\\n\\n### 90-day acquisition moves\\n\\n- Weeks 1–2: Domain consolidation decision + 301 plan. App Store listing rewrite first pass.\\n- Weeks 3–4: Domain 301s executed. GSC migration. SEO Pillar 1 hub drafted.\\n- Weeks 5–8: Pillar 1 hub + 3 spokes published. Pillar 2 (Eye Mask) hub + listicle published. Alex's LinkedIn cadence operationalized via Typefully. peer-reviewed psychophysiology study lands on dedicated `/science` page.\\n- Weeks 9–12: Pillar 4 (WELL/B2B) cornerstone published. Sound Philosophy goes public at `/research/sound-philosophy`. First PR push: pitch study + longevity-influencer hook to 5 outlets.\\n\\n### 12-month acquisition outlook\\n\\n- Q1 (Months 1–3): Foundation. SEO pillars staked. App Store rewrite shipped. LinkedIn cadence stable. PR push launched.\\n- Q2 (Months 4–6, post-seed close): Paid acquisition pilot at $5–10K/mo. SEO compounding — Pillar 1 ranking. First B2B install reference case live.\\n- Q3 (Months 7–9): Paid scales to $20–30K/mo if unit economics hold. All four pillars producing. App GA — new GTM moment.\\n- Q4 (Months 10–12): Compound channels live. 50+ pieces of pillar content. First Quietude Guides program pilot creating local SEO + earned media.\\n\\n### Skills + tools\\n\\n- **Skills:** `seo-audit`, `ai-seo`, `programmatic-seo`, `schema`, `content-strategy`, `competitors`, `launch`, `ads`, `ad-creative`, `social`, `typefully`, `analytics`, `copywriting`, `marketing-website-design`, `free-tools`\\n- **MCPs / APIs:** Ahrefs API, DataForSEO API, Typefully MCP (LinkedIn scheduling), GA4 MCP (when wired), GitHub MCP (`quietude-promo` repo work), Notion (knowledge directory), Stripe MCP (LTV / paid-CAC math), `agent-browser` (LinkedIn drafting + testing), `defuddle` (research)\\n\\n---\\n\\n## 5. Activation\\n\\n> *\\\"Once someone tries Quietude, do they have an experience that converts?\\\"*\\n\\n### Current state\\n\\nDay 1 → paid: **1.34%**. Day 7 → paid: **3.73%**. Day 35 → paid: **5.46%**. *The funnel shape is the signal.* The ~4× lift over 35 days means the product converts given time and contact — both of which the current onboarding undermines and the lifecycle layer doesn't yet provide.\\n\\nCaveats: app is in throttled beta. Metrics are noisy. Don't optimize against absolutes; optimize against funnel *shape* and *cohort comparison*.\\n\\n### The plan\\n\\n**Move 1 — Kill the headphones hard-gate (bedrock fix, this week).**\\nConfirmed conversion drop after the gate shipped. The fix isn't better copy on the gate — it's removing the gate. Replace with passive headphone detection + soft single-line nudge. No regret change. Full reasoning in `onboarding-recommendation.md`.\\n\\n**Move 2 — Run the three-variant onboarding test.**\\nThree variants, each a pure expression of one belief about what drives activation in this ICP:\\n- **Variant 1 — Trust First.** Bold promise + clinical anchor + testimonial wall + 1-line mechanism. Tests whether the saturated ICP needs framing before they'll invest.\\n- **Variant 2 — Seen First.** Multi-step diagnostic → AI-generated \\\"we see you\\\" summary → personalized session. Tests whether being accurately named is the conversion event.\\n- **Variant 3 — Felt First.** Audio starts on app open. ~15 words on screen. The session IS the onboarding. Tests whether the product can carry it cold.\\n\\nTest sequence (sequential, ~7 weeks to a winner): bedrock baseline → V3 vs. baseline → winner vs. V1 → winner vs. V2. Full system in `onboarding-recommendation.md`.\\n\\n**Move 3 — App Store listing rewrite.**\\nHighest-leverage non-site asset. Rewrite in brand voice. Lead with meditation-vs-regulation. Screenshot variations to test. This is also an Acquisition move (organic discovery) but it lives here because it's the threshold to the trial.\\n\\n**Move 4 — Customer.io Flow 2 (held until UI stable).**\\nThe 8-email / 14-day onboarding sequence is drafted and on-brand. Holding the ship because the emails reference in-app screens that will change during the onboarding rebuild. Once a winning onboarding variant ships, Flow 2 gets a copy refresh against the final UI and goes live.\\n\\n**Move 5 — Paywall + pricing review (cross-cuts to Revenue).**\\nWhat's the current trial structure? Length, paywall trigger, intro pricing? When the funnel shape is \\\"lift over 35 days,\\\" extending trial may convert better than aggressively gating earlier. To be audited in Q1.\\n\\n### 90-day activation moves\\n\\n- Week 1: Headphones gate removed. Baseline established.\\n- Weeks 2–3: Variant 3 (Felt First) prototyped, instrumented, shipped to a test cohort.\\n- Weeks 4–5: Read Variant 3 vs. baseline. Decide ship/iterate. Begin Variant 1 build.\\n- Weeks 6–7: Variant 1 (Trust First) live.\\n- Weeks 8–9: Read V1 vs. winner. Begin Variant 2 build.\\n- Weeks 10–11: Variant 2 (Seen First) live.\\n- Week 12: Final read. Winning variant scheduled for permanent ship. Flow 2 unblocked.\\n\\n### 12-month activation outlook\\n\\n- Q1: Winning variant identified and shipped.\\n- Q2: Flow 2 ships. Paywall A/B tests start.\\n- Q3: GA launch — onboarding re-validated at higher traffic. Cohort segmentation by acquisition source (Shopify/eye-mask vs. direct vs. ambassador vs. paid) starts to drive variant forks.\\n- Q4: Onboarding is no longer the bottleneck. Focus moves to Activation → Retention transition (sessions 2–7).\\n\\n### Skills + tools\\n\\n- **Skills:** `onboarding`, `signup`, `cro`, `cro`, `paywalls`, `popups`, `copywriting`, `copy-editing`, `copycraft`, `marketing-website-design`, `ab-testing`, `marketing-psychology`\\n- **MCPs / APIs:** App Store Connect (manual + `dev-browser` for screenshot automation), GitHub MCP (`quietude-app` app repo for onboarding code), Figma / Pencil MCP (for onboarding screen design), Customer.io MCP (for any in-app/email coordination), GA4 MCP (activation events)\\n\\n---\\n\\n## 6. Retention\\n\\n> *\\\"Once someone converts, do they stay — and deepen?\\\"*\\n\\n### Current state\\n\\n**Headline metric (per seed deck): 38% 12-month retention** — nearly double the category average (~20%). This is the strongest single retention signal in the deck and one of the most undermarketed claims Quietude owns.\\n\\n**App Store snapshot, 2026-05-16:** 145 paid, 42 churned (~29% monthly churn). Definition mismatch with the 38% claim — to reconcile. Possibly: 38% is annual cohort retention (people who paid month 1 and still pay month 12), 29% is gross monthly churn (people who paid this month who didn't pay next month). Both can be true. Need to clarify which metric is reported externally and which is the actual product health signal.\\n\\n### The plan\\n\\n**Move 1 — Ship Flow 6 first (Eye Mask Post-Purchase).**\\nPer kickoff decision and the onboarding-recommendation doc: this is the ship-ready flow. Hardware-anchored, doesn't reference in-app screens, can ship today. Wires the hardware → app activation path (eye mask buyers should get a free 6-month Premium trial — formalize this as part of the flow).\\n\\n**Move 2 — Ship Flow 4 second (Lapsed User Re-engagement).**\\nFive emails over 38 days. Language is universal — doesn't depend on app UI state. Ship after Flow 6 is live.\\n\\n**Move 3 — Hold Flow 2 (Onboarding).**\\nEight emails over 14 days. Holds until app UI stabilizes post-onboarding-rebuild. Don't ship copy that will need rewriting in 8 weeks.\\n\\n**Move 4 — Customer.io subscription center with opt-in topics.**\\nPer kickoff decision. Topics: events, app updates, somatics & nervous system, eye mask promotions. Users self-segment. Improves deliverability (lower complaint rates) and gives lifecycle a richer segmentation surface.\\n\\n**Move 5 — Mira post-session reflection (when scoped).**\\nMost powerful retention move medium-term. After a session, Mira asks *\\\"What did you notice?\\\"* Optional preset chips + free text. Two payoffs: (a) gives Mira priors for personalization on session 2+, (b) reflection responses become a content + segmentation goldmine for the team. Scope question for Devon — does Mira currently support this, or is it new build?\\n\\n**Move 6 — Hardware → app activation flow.**\\nThe eye-mask-buyer-becomes-Premium-subscriber path is hinted in the seed deck (blended CAC via hardware) but isn't visible in the App Store dashboard. Audit the existing flow: does an eye mask Shopify purchase actually deliver a free Premium code? How is it redeemed? What's the conversion rate? This is foundational to the \\\"B2C wedge\\\" thesis.\\n\\n**Move 7 — Reconcile the retention metric.**\\nWhat's the actual definition of \\\"38% 12-month retention\\\"? Cohort? Plan type (monthly vs. annual)? Survives this even if the answer is uncomfortable — the team and investors need to be talking about the same metric.\\n\\n**Move 8 — Annual plan as default (cross-cuts to Revenue).**\\nIndustry pattern: defaulting to annual reduces churn anxiety and improves LTV. To test in Q2.\\n\\n### 90-day retention moves\\n\\n- Weeks 1–2: Flow 6 (eye mask post-purchase) ships. Address fixes from kickoff review (study link line break, CAN-SPAM footer, founder face-bubble signature, Judge.me reviews).\\n- Weeks 3–4: Flow 4 (lapsed user re-engagement) ships.\\n- Weeks 5–6: Customer.io subscription center built and live.\\n- Weeks 7–8: Hardware → app activation flow audited and documented. Fix any leaks.\\n- Weeks 9–10: Retention metric reconciliation (with Devon).\\n- Weeks 11–12: Win-back campaign for churned cohort — test re-activation copy.\\n\\n### 12-month retention outlook\\n\\n- Q1: Flows 6 + 4 firing. Subscription center live.\\n- Q2: Flow 2 ships (post-onboarding-rebuild). Mira post-session reflection in production. Annual plan default tested.\\n- Q3: GA launch — retention metrics re-baselined at higher volume. Cohort-based lifecycle flows (eye mask vs. direct app install).\\n- Q4: Full lifecycle compound. Retention is no longer a top-three concern — focus moves to Referral and Revenue.\\n\\n### Skills + tools\\n\\n- **Skills:** `emails`, `churn-prevention`, `copywriting`, `copy-editing`, `paywalls`, `ab-testing`\\n- **MCPs / APIs:** **Customer.io MCP** (validated on kickoff — non-technical team can ship flows), Shopify (eye mask buyers as event source), Stripe MCP (subscription state, churn cohort pulls), GA4 MCP (session events, retention curves)\\n\\n---\\n\\n## 7. Referral\\n\\n> *\\\"Do retained users bring more users — and at what cost?\\\"*\\n\\n### Current state\\n\\n~5 inbound ambassadors waiting (per kickoff). Dub.co set up. No formal program yet. WOM happens naturally per Alex's UA breakdown.\\n\\nThis is one of the strongest leading indicators in the business: 5 unaffiliated people have raised their hand asking to bring Quietude to their network *before any program exists*. That signal doesn't show up in apps with weaker product-market fit.\\n\\n### The plan\\n\\n**Move 1 — Launch the ambassador program with the 5 inbound.**\\nTier 1 of the program. Per-ambassador landing pages (e.g., `quietude.app/with/sarah`). Dub.co tracks attribution. Commission structure to determine (per kickoff, $/sub or rev-share TBD). Soft-launch with the 5 — treat as pilot cohort, gather feedback, refine before opening applications.\\n\\n**Move 2 — Build the share-after-shift moment.**\\nThe Mira post-session reflection (see Retention) is the natural moment to surface a share prompt. After a user reports a felt shift, offer: *\\\"Want to share Quietude with someone who needs this?\\\"* Single-line, never pushy. Most powerful WOM mechanism: gift-a-month flow where the recipient gets a discounted or free intro.\\n\\n**Move 3 — Founder amplification (Alex + Sam as ambassador-zero).**\\nAlex mentioning the fCMO engagement in fundraise pitches (permission granted). Reciprocal mentions in fCMO-side content. Sam's clinical network → practitioner ambassador pool.\\n\\n**Move 4 — Quietude Guides cert pilot (long-term, Q3+).**\\nThe Guides program is the Phase-2 referral compound (per seed deck). 500–1,000 Guides across 50+ cities by Y3–5. First cert pilot: 3–5 hosts who run live sessions, get a rev-share + co-marketing. Builds local SEO + earned media + ambassador-of-ambassadors flywheel. Hold until paid + lifecycle are firing — Guides is a multi-quarter build.\\n\\n**Move 5 — Eye mask gifting flow.**\\nHardware referral is rare and powerful. *\\\"Send a friend an Quietude eye mask. They get the mask + a free 3-month Premium. You get a credit toward your next thing.\\\"* Holiday/gifting peak windows are the test.\\n\\n### 90-day referral moves\\n\\n- Weeks 1–4: Ambassador program scoped, commission structure decided, per-ambassador landing page template built, 5 inbound onboarded.\\n- Weeks 5–8: First ambassador-driven sales tracked via Dub. Attribution and payout flow validated.\\n- Weeks 9–12: Open applications for next 10–15 ambassadors. Begin Quietude Guides scoping.\\n\\n### 12-month referral outlook\\n\\n- Q1: Ambassador program live with 5–10 active.\\n- Q2: 15–25 active ambassadors. Share-after-shift moment in production (post-Mira reflection).\\n- Q3: Guides cert pilot launched (3–5 hosts). Eye mask gifting flow live for holiday peak.\\n- Q4: 50+ ambassadors + 5–10 Guides. Referral driving 15–25% of new D2C subs.\\n\\n### Skills + tools\\n\\n- **Skills:** `referrals`, `social`, `copywriting`, `marketing-website-design` (per-ambassador landing pages)\\n- **MCPs / APIs:** Dub.co (attribution — already in stack), Stripe MCP (commission accounting + payouts), GitHub MCP (landing page deployment in `quietude-promo` or new `quietude-ambassadors` repo), Customer.io MCP (ambassador lifecycle: onboarding, monthly performance digest, payout notification)\\n\\n---\\n\\n## 8. Revenue\\n\\n> *\\\"What do we charge, who pays, and how does that compound?\\\"*\\n\\n### Current state\\n\\n| Product | Price | Volume signal |\\n|---|---|---|\\n| Quietude App + Mira | ~$30/mo | 145 paid subs (App Store snapshot 2026-05-16) |\\n| Quietude Eye Mask | ~$45 | 5K in stock, longevity-influencer PR-driven sales |\\n| Quietude Audio (speakers) | ~$7,500 | Niche, founder-led |\\n| Quietude Spaces (B2B install) | $50–200K | Aurora flagship in-flight (~€250K), pipeline of 4 venues |\\n| Quietude Experiences (events) | Varies | 15K+ historical participants |\\n| Quietude Guides | Rev share | Not yet operational |\\n\\n**Revenue to date: ~$500K on ~$250K raised.** Capital-efficient. Hardware + B2B + app subs all contributing.\\n\\n**MRR (App Store snapshot): $592.** Beta-throttled, not steady-state. The implied ~$4/sub/mo against $30/mo list suggests heavy annual plan adoption (which compresses monthly revenue but improves LTV) or significant promotional pricing — to reconcile with Alex.\\n\\n### The plan\\n\\n**Move 1 — Pricing audit.**\\nWhat's actually being charged today? List price, common plan mix, intro pricing, churn-recovery offers? The $4/sub/mo implied math doesn't tell a clean story — need ground truth before recommending changes.\\n\\n**Move 2 — Annual plan as default (test).**\\nIndustry pattern, cross-references to Retention. Test in Q2.\\n\\n**Move 3 — Hardware → app bundling formalized.**\\nPer partner-event-business framing in the seed deck: blended CAC via hardware → app subscription is the play. Today an eye mask buyer gets... what, exactly? Free Premium? Trial code? Audit + formalize. The eye mask is the wedge; the app is the LTV.\\n\\n**Move 4 — Eye mask Shopify storefront optimization.**\\nThe current page underperforms what it could. Add: SEO targeting (\\\"weighted sleep mask,\\\" \\\"blackout sleep mask\\\"), Judge.me reviews (kickoff decision), 30-day return policy (kickoff decision), upsell flow into Premium app.\\n\\n**Move 5 — Consider Amazon listing for eye mask.**\\nAmazon takes margin but is its own discovery engine. Test as v2 distribution if Shopify volume validates.\\n\\n**Move 6 — B2B install case studies + sales material.**\\nAlex owns B2B sales but marketing supports with: post-install case studies (Aurora as the flagship), `/partner` page rewrite in voice, Pillar 4 SEO content. Each B2B install is a ~$430K/year recurring + reference-case multiplier.\\n\\n**Move 7 — Data licensing (long-term, flag for ops stack).**\\nPer seed deck Y10–15 value pool: $100–160M/yr. Not immediate revenue. Belongs in the 24-month strategic agenda. Flag here so we don't lose sight.\\n\\n### 90-day revenue moves\\n\\n- Weeks 1–2: Pricing audit. Reconcile implied vs. listed MRR.\\n- Weeks 3–4: Hardware → app activation flow audited (also Retention move 6).\\n- Weeks 5–8: Eye mask Shopify page rewrite + SEO optimization + Judge.me + return policy. Aurora case study scaffolded for post-install.\\n- Weeks 9–12: Annual plan default test scoped.\\n\\n### 12-month revenue outlook\\n\\n- Q1: Pricing audit closes. Hardware → app activation formalized.\\n- Q2: Annual plan default test live. Eye mask Shopify producing measurable lift.\\n- Q3: B2B install case studies (1–2) published. GA launch + new pricing tier consideration (e.g., a higher-tier Mira-heavy plan?).\\n- Q4: Pricing optimized via test results. Hardware → app blended CAC tracked and reported. First numbers on the data-licensing thesis (still very early).\\n\\n### Skills + tools\\n\\n- **Skills:** `pricing`, `paywalls`, `sales-enablement`, `revops`, `ab-testing`, `copywriting`\\n- **MCPs / APIs:** Stripe MCP (pricing tests, subscription analytics, churn cohort, blended CAC math), Customer.io MCP (paywall-related lifecycle), Shopify (eye mask transactions), GA4 MCP (revenue events), Notion (commercial knowledge directory)\\n\\n---\\n\\n## 9. 90-day roadmap\\n\\nTactical execution layer. Each item is AARRR-tagged so priority is visible.\\n\\n### Weeks 1–2 — Unblock\\n\\n| Move | Stage | Owner |\\n|---|---|---|\\n| Kill the headphones hard-gate | Activation | Casey + Devon |\\n| Domain consolidation decision documented | Acquisition | Casey + Alex |\\n| 301 plan drafted (page-by-page) | Acquisition | Casey |\\n| App Store listing rewrite — first pass | Activation + Acquisition | Casey + Alex + Sam (voice review) |\\n| Flow 6 (eye mask post-purchase) ships | Retention | Casey + Customer.io MCP |\\n| Ambassador program scoping doc | Referral | Casey |\\n| Pricing audit kicked off | Revenue | Casey + Alex |\\n\\n### Weeks 3–4 — Foundation\\n\\n| Move | Stage | Owner |\\n|---|---|---|\\n| Domain consolidation 301s executed | Acquisition | Devon + Casey |\\n| GSC + GA4 stood up on `quietude.app` | Acquisition | Casey |\\n| SEO Pillar 1 hub drafted (Nervous System Regulation) | Acquisition | Casey |\\n| `/science` hub built with peer-reviewed psychophysiology study | Acquisition + brand | Casey + Sam |\\n| Variant 3 (Felt First) onboarding prototyped + tested | Activation | Casey + Devon |\\n| Flow 4 (lapsed user) ships | Retention | Casey |\\n| Ambassador program: 5 inbound onboarded | Referral | Casey |\\n| Hardware → app activation flow audited | Retention + Revenue | Casey + Devon |\\n| App Store listing rewrite — final + ship | Activation + Acquisition | Alex + Sam + Casey |\\n\\n### Weeks 5–8 — Velocity\\n\\n| Move | Stage | Owner |\\n|---|---|---|\\n| Pillar 1 hub + 3 spokes published | Acquisition | Casey |\\n| Pillar 2 hub (Eye Mask) + listicle published | Acquisition | Casey |\\n| Alex's LinkedIn cadence operationalized (Typefully) | Acquisition | Alex + Casey |\\n| First PR push: study + longevity-influencer hook to 5 outlets | Acquisition | Casey + Alex |\\n| Variant 3 read; ship or iterate | Activation | Casey |\\n| Variant 1 (Trust First) prototyped + tested | Activation | Casey + Devon |\\n| Customer.io subscription center built | Retention | Casey |\\n| Eye mask Shopify storefront rewrite (SEO + reviews + return) | Acquisition + Revenue | Casey + Alex |\\n| First ambassador attribution verified via Dub | Referral | Casey |\\n\\n### Weeks 9–12 — Compound\\n\\n| Move | Stage | Owner |\\n|---|---|---|\\n| Pillar 4 (WELL/B2B) cornerstone published | Acquisition | Casey |\\n| 3 more Pillar 1 spokes published | Acquisition | Casey |\\n| Sound Philosophy published at `/research/sound-philosophy` | Acquisition + brand | Alex + Casey |\\n| Variant 1 read; begin Variant 2 (Seen First) build (Mira-dependent) | Activation | Casey + Devon |\\n| Win-back campaign for churned cohort | Retention | Casey |\\n| Annual plan default test scoped | Revenue | Casey + Alex |\\n| Open ambassador applications for next 10–15 | Referral | Casey |\\n| 90-day review + Q2 plan recalibration | Cross-cutting | Casey + Alex |\\n\\n---\\n\\n## 10. 12-month outlook\\n\\nQuarterly milestones with funding-stage capability unlocks named explicitly.\\n\\n### Q1 — Months 1–3 (Jun–Aug 2026)\\n\\n**Funding state:** Pre-seed-close. Paid budget = $0. fCMO + founder-led + tool costs only.\\n\\n**Focus:** Foundation. Plug the leaks. Stake the SEO ground. Get lifecycle firing.\\n\\n**Outcomes by end of Q1:**\\n- Headphones gate gone; onboarding winner identified\\n- All four SEO pillars seeded (hub + first spokes)\\n- Lifecycle Flows 4 + 6 live\\n- App Store listing in brand voice\\n- 5 ambassadors active\\n- Pricing audit closed\\n- Domain consolidated\\n\\n**KPI targets:** Onboarding Day 1 → paid lift of 25–50%. Organic traffic 500–1,500/mo. App Store conversion rate +20%.\\n\\n### Q2 — Months 4–6 (Sep–Nov 2026)\\n\\n**Funding state:** Seed close (~Q3 2026 target). First paid budget unlock: $5–10K/mo test.\\n\\n**Focus:** Validate paid. Scale winning onboarding. Add Flow 2.\\n\\n**Outcomes by end of Q2:**\\n- Paid acquisition firing on Apple Search Ads + Meta\\n- Onboarding winner permanently shipped\\n- Flow 2 (onboarding emails) shipped\\n- Mira post-session reflection in production\\n- 15–25 ambassadors active\\n- First B2B install reference case (Aurora) published\\n- Annual plan default tested\\n\\n**KPI targets:** Paid CAC < $50 blended. Organic traffic 1,500–3,500/mo. Retention curves visibly improving.\\n\\n### Q3 — Months 7–9 (Dec 2026–Feb 2027)\\n\\n**Funding state:** Seed deployment. Paid scales to $20–50K/mo if unit economics hold. First marketing hire (lifecycle + content manager).\\n\\n**Focus:** Scale + diversify. App GA. B2B reference cases compound.\\n\\n**Outcomes by end of Q3:**\\n- App GA launched with new GTM moment (PR + ad creative refresh + Pillar 3 spatial-audio-science content cycle)\\n- First Quietude Guides cert pilot (3–5 hosts)\\n- All four pillars producing weekly content\\n- Eye mask gifting flow live for holiday peak\\n- New marketing hire onboarded\\n\\n**KPI targets:** Paid + organic blended CAC stabilizing. App GA conversion +50% from beta baseline. Guides pilot validates rev-share + co-marketing model.\\n\\n### Q4 — Months 10–12 (Mar–May 2027)\\n\\n**Funding state:** Pre–Series A. Paid scaling continues. Series A pitch in motion.\\n\\n**Focus:** Compound. Position for Series A.\\n\\n**Outcomes by end of Q4:**\\n- Compound channels (organic + ambassador + Guides + lifecycle) producing 50%+ of new subs\\n- 50+ ambassadors, 5–10 Guides\\n- 4 SEO pillars + 30+ pieces of content live\\n- Paid scaling to $50–150K/mo if validated\\n- Series A narrative: clinical evidence + activation lift + lifecycle compounding + B2B reference case pipeline\\n\\n**KPI targets:** D2C ARR run-rate trajectory clear. Blended LTV/CAC > 3. Founder narrative + data + reference cases ready for Series A.\\n\\n---\\n\\n## 11. Marketing operations stack\\n\\nThis is what makes the plan executable at Quietude's team size. A 4-person founder team + fCMO + agentic tooling can ship the output of a 15–20-person traditional marketing org — because the marketing skill library and MCP integrations do the orchestration.\\n\\n### The thesis\\n\\nEvery move in the AARRR breakdown above maps to (a) one or more marketing skills that operationalize the work, and (b) one or more MCP/API integrations that let it execute without a dedicated headcount per channel.\\n\\nThe fCMO's job is to:\\n1. Define the strategy and sequencing (this doc)\\n2. Run the skills against the right context at the right time\\n3. Maintain the shared context (`quietude-context`) and tooling so Alex + Sam + future hires can plug in\\n4. Hand off operational work to humans (or future hires) only where the cost of agentic execution > human execution\\n\\n### Skills mapped to AARRR stages\\n\\n| Stage | Primary skills | Supporting skills |\\n|---|---|---|\\n| **Acquisition** | `seo-audit`, `ai-seo`, `programmatic-seo`, `schema`, `content-strategy`, `competitors`, `ads`, `ad-creative`, `social`, `typefully` | `launch`, `free-tools`, `analytics`, `cold-email`, `copywriting`, `marketing-website-design` |\\n| **Activation** | `onboarding`, `signup`, `paywalls`, `cro`, `copywriting`, `copy-editing`, `copycraft` | `marketing-website-design`, `ab-testing`, `marketing-psychology`, `cro`, `popups` |\\n| **Retention** | `emails`, `churn-prevention` | `copywriting`, `copy-editing`, `ab-testing`, `paywalls` |\\n| **Referral** | `referrals`, `social` | `copywriting`, `marketing-website-design`, `emails` |\\n| **Revenue** | `pricing`, `paywalls`, `sales-enablement`, `revops` | `ab-testing`, `copywriting` |\\n| **Cross-cutting** (brand, intelligence) | `product-marketing`, `customer-research`, `marketing-psychology` | `marketing-ideas`, `diagram-maker` |\\n\\n### MCPs / APIs mapped to stages\\n\\n| Stage | Existing connections at Quietude | Tooling layer (Casey's fCMO stack) |\\n|---|---|---|\\n| **Acquisition** | App Store Connect (manual), Shopify, GA4 (in progress), Notion | Ahrefs API, DataForSEO API, Typefully MCP, GitHub MCP (`quietude-promo`), `agent-browser`, `defuddle` |\\n| **Activation** | App Store Connect, Customer.io, Shopify | App Store Connect (via `dev-browser` for screenshot automation), Figma / Pencil MCP, GitHub MCP (`quietude-app` app repo), Stripe MCP |\\n| **Retention** | **Customer.io (with Claude MCP — validated on kickoff)**, Stripe, Shopify | Customer.io MCP, Stripe MCP, GA4 MCP |\\n| **Referral** | Dub.co, Stripe | Dub.co, Stripe MCP, GitHub MCP (per-ambassador landing pages), Customer.io MCP |\\n| **Revenue** | Stripe, Shopify, Customer.io | Stripe MCP, Shopify, GA4 MCP, Notion |\\n| **Cross-cutting** | Notion, GitHub (`quietude-context`) | Notion, GitHub MCP, `defuddle`, `obsidian-cli` (for Casey's working notes) |\\n\\n### The Customer.io MCP unlock (concrete example)\\n\\nPer kickoff call: *\\\"Built live on call — abandoned-cart flow drafted using Customer.io's Claude MCP. Validated that non-technical team can use the skill pattern independently.\\\"*\\n\\nThis is the operational proof that the stack works. Alex, who is not a developer, drafted a working lifecycle flow with Claude + Customer.io MCP in real time on a kickoff call. The same pattern applies to: Flow 4 ship (lapsed user re-engagement), subscription center build, win-back campaign, eye mask gifting flow, ambassador lifecycle. The fCMO's role becomes orchestration + brand-voice QA, not hand-cranking each email.\\n\\n### Capability unlocks by funding stage\\n\\n| Stage | Headcount | Tooling | Channels live |\\n|---|---|---|---|\\n| **Pre-seed-close (now)** | fCMO + founder team | All current tooling + Casey's marketing skill library + MCP layer | Organic only (SEO, content, App Store, LinkedIn, events, WOM, ambassador) |\\n| **Seed close (~Q3 2026)** | + first marketing hire (lifecycle/content) by end of Q3 | + paid ad accounts (Apple Search Ads, Meta, LinkedIn) | + paid acquisition pilot $5–10K/mo |\\n| **Seed deployment (Q3–Q4 2026)** | + designer (potentially fractional) | + analytics expansion (Mixpanel or Amplitude if needed) | + paid scaling $20–50K/mo, + Guides cert pilot |\\n| **Series A (2027)** | + performance marketing lead + content lead | + dedicated tooling spend (~$2–5K/mo software) | + paid scaling $50–150K/mo, + international, + B2B vertical expansion |\\n\\nThe marketing skill library scales these stages. Every channel added doesn't require a 1:1 headcount increase because each skill encodes the workflow.\\n\\n---\\n\\n## 12. Tactical idea bank — 139-idea cross-reference\\n\\nThe `marketing-ideas` skill catalogs 139 proven marketing tactics. Sections 4–8 (AARRR) prescribe what we're *doing*. This section maps the full universe of what's *possible* — every idea cross-referenced to the AARRR stage it primarily serves, with Quietude applicability and timing.\\n\\nThis is the exhaustive menu. The plan above is the curated path. When we move to Q2 / Q3 / Series A and unlock new capacity, this is the inventory we pull from.\\n\\n**Status legend:**\\n\\n- **Now (Q1)** — already in the 90-day plan OR can run alongside it without new capacity\\n- **Q2** — post-bedrock-fix, post-foundation; second-quarter layer-ins\\n- **Q3+** — post-seed-close, post-GA; expansion moves\\n- **Q4+** — long-game / large-investment moves\\n- **Skip / off-brand** — incompatible with Quietude's brand voice, business model, or product category\\n\\n### 12.1 Acquisition ideas (88 mapped)\\n\\n**Now (Q1):**\\n\\n| # | Idea | Quietude note |\\n|---|---|---|\\n| 1 | Easy Keyword Ranking | SEO plan Tier-1 cluster (nervous system, sleep mask, B2B) targets this directly |\\n| 2 | SEO Audit | Run `/seo-audit quietude.app` quarterly; publish findings as content |\\n| 5 | Content Repurposing | Sound Philosophy → essays → LinkedIn posts → newsletter → podcast loop |\\n| 6 | Proprietary Data Content | peer-reviewed psychophysiology study now; anonymized Quietude HRV / sleep dataset later |\\n| 7 | Internal Linking | Built into the pillar/spoke structure of the SEO plan |\\n| 10 | Parasite SEO | Alex's LinkedIn already does this; consider mirror to Substack |\\n| 12 | Marketing Jiu-Jitsu | Meditation-vs-Regulation IS this — turn \\\"meditation works\\\" assumption against itself |\\n| 36 | Quora Marketing | Answer \\\"why meditation doesn't work for me\\\" + HRV + somatic questions |\\n| 37 | Reddit Keyword Research | Mine r/somatic, r/CPTSD, r/HSP, r/ADHD for ICP language (feeds Customer Language #139) |\\n| 39 | LinkedIn Audience | Alex's channel productized — primary D2C top-of-funnel today |\\n| 59 | Article Quotes | HARO / Help-A-B2B-Writer for Alex + Sam — easy press wins |\\n| 70 | Conference Speaking | Alex: WELL Conference, biophilic design events, Mindful Leadership Summit |\\n| 74 | Press Coverage | Pitch peer-reviewed study + longevity-influencer hook to 5 outlets in Q1 |\\n| 109 | Public Demos | Live Quietude events ARE this; instrument the in-person → app conversion |\\n| 114 | Moneyball Marketing | Already practicing — asymmetric SEO keywords, undervalued channels |\\n| 133 | Investor Marketing | Alex's raise — leverage angel backchannel for PR + intros |\\n\\n**Q2:**\\n\\n| # | Idea | Quietude note |\\n|---|---|---|\\n| 3 | Glossary Marketing | Sound + nervous system glossary — \\\"what is polyvagal,\\\" \\\"what is HRV,\\\" \\\"what is somatic listening\\\" |\\n| 8 | Content Refreshing | Revisit Pillar 1 quarterly with new data and search-intent updates |\\n| 11 | Competitor Comparison Pages | Quietude vs. Calm / Headspace / Brain.fm / Endel / Wavepaths — high-intent SERPs |\\n| 13 | Competitive Ad Research | SpyFu + Facebook Ad Library before launching paid |\\n| 17 | Quiz Marketing | \\\"What's your nervous system profile?\\\" — generates personalization seed + lead capture |\\n| 25 | Facebook Ads | Eye mask creative + somatic content + retargeting from event attendees |\\n| 26 | Instagram Ads | Visual product + Reels-native ads (eye mask especially) |\\n| 28 | LinkedIn Ads | B2B venue buyers + investor-adjacent ICP |\\n| 31 | Google Ads | Apple Search Ads first (App Store intent); Google for eye mask + B2B |\\n| 38 | Reddit Marketing | Authentic participation in r/somatic, r/HSP, r/ADHD after content base exists |\\n| 40 | Instagram Audience | Eye mask + somatic creators; Reels-native |\\n| 44 | Comment Marketing | Thoughtful comments on Huberman / the partner-event-business / Tim Ferriss / wellness creators |\\n| 49 | Monthly Newsletters | Either Quietude-branded or sync with Sam's Sam's Substack newsletter |\\n| 54 | Affiliate Discovery via Backlinks | Find who links to Calm/Headspace/Brain.fm — pitch them on Quietude affiliate program |\\n| 58 | Newsletter Swaps | the partner-event-business, founder wellness Substacks, Alex's investor network |\\n| 64 | Community Sponsorship | Somatic newsletters, wellness Substacks, founder communities |\\n| 65 | Live Webinars | Alex + Sam hosting \\\"Sound + the Nervous System\\\" |\\n| 101 | Industry Interviews | Alex + Sam interview category experts (becomes seed of Quietude podcast) |\\n| 102 | Social Screenshots | Mira reflection responses (anonymized, consented) — social proof gold |\\n| 108 | Changelogs | Public changelog at `quietude.app/changes` — product momentum signal |\\n| 115 | Curation as Marketing | Curated \\\"field recordings of the year\\\" feature; Quietude Spaces directory |\\n| 135 | Support as Marketing | Surface customer support / Mira reflection moments as content |\\n| 138 | Podcast Tours | Alex on Huberman, the partner-event-business, Tim Ferriss, Rich Roll, Rangan Chatterjee |\\n\\n**Q3+:**\\n\\n| # | Idea | Quietude note |\\n|---|---|---|\\n| 4 | Programmatic SEO | Quietude Guides city pages once Guides program scales |\\n| 9 | Knowledge Base SEO | When help docs scale enough to have problem-solution coverage |\\n| 14 | Side Projects | Eventually a free Quietude-adjacent tool that lives outside the app |\\n| 15 | Engineering as Marketing | HRV interpretation guide; nervous system self-assessment; sound bath finder directory |\\n| 18 | Calculator Marketing | Sleep latency calculator; overstimulation index |\\n| 20 | Microsites | For specific GTM moments (e.g., Mira GA launch) |\\n| 23 | Podcast Advertising | Huberman, Tim Ferriss, Rich Roll, the partner-event-business — host-read most relevant |\\n| 24 | Pre-targeting Ads | Warm audiences via content before direct-response |\\n| 29 | Reddit Ads | r/HSP, r/ADHD, r/somatic — high ICP density, low advertiser saturation |\\n| 30 | Quora Ads | Intent-rich for \\\"why meditation doesn't work\\\" queries |\\n| 32 | YouTube Ads | Pre-roll on Huberman / Lex Fridman / wellness creator videos |\\n| 33 | Cross-Platform Retargeting | Standard layer once paid is firing |\\n| 35 | Community Marketing | Quietude Spaces community (Discord/Circle); host monthly drop-ins |\\n| 42 | Short Form Video | TikTok / Reels — somatic education + eye mask UGC |\\n| 55 | Influencer Whitelisting | Run ads through ambassador / Guide accounts for authenticity |\\n| 57 | Expert Networks | Quietude Guides program IS this — certified hosts who can market |\\n| 60 | Pixel Sharing | Standard once paid is firing |\\n| 61 | Shared Slack Channels | Partner venue Slacks (Aurora, Lumen, Stillwater) |\\n| 63 | Integration Marketing | Apple Health (HRV data), Oura, Whoop — co-marketing |\\n| 66 | Virtual Summits | Quietude participates or hosts |\\n| 68 | Local Meetups | Cities with high ICP density (SF, NYC, LA, Austin) |\\n| 69 | Meetup Sponsorship | Sponsor wellness / biohacking meetups |\\n| 72 | Conference Sponsorship | Industry conferences once budget unlocks |\\n| 75 | Fundraising PR | \\\"Quietude raises $3M\\\" moment when seed closes |\\n| 78 | Product Hunt Launch | Mira public launch moment |\\n| 79 | Early-Access Referrals | App GA early-access list (cross-references to Referral) |\\n| 81 | Early Access Pricing | App GA — early-access tier locked in for first cohort |\\n| 82 | Product Hunt Alternatives | BetaList, Launching Next, AlternativeTo at GA |\\n| 97 | Playlists as Marketing | Quietude curates Spotify playlists for somatic listening |\\n| 98 | Template Marketing | Free \\\"nervous system reset\\\" protocol PDFs |\\n| 100 | Promo Videos | High-quality brand films — Ed Dorsey advises, Matt Mikkelsen field audio |\\n| 103 | Online Courses | Alex's Sound Philosophy course; Sam's somatic methodology course |\\n| 107 | Podcasts | Quietude podcast — interview format with category experts and customers |\\n| 111 | Challenges as Marketing | \\\"21-day nervous system reset\\\" — tasteful, no fitness-bro tone |\\n| 113 | Controversy as Marketing | Meditation-vs-Regulation IS mild controversy — lean in carefully |\\n| 126 | YouTube Reviews | Pitch Quietude to wellness YouTubers — Huberman fan-creator tier |\\n| 127 | YouTube Channel | Sound design behind-the-scenes; Sam session demos |\\n| 129 | Review Sites | App Store reviews actively managed; Trustpilot for eye mask Shopify |\\n| 130 | Live Audio | Twitter Spaces / LinkedIn Audio with Alex on sound + body |\\n| 134 | Certifications | Quietude Guides cert IS this — Q3+ pilot |\\n\\n**Q4+ / long-game:**\\n\\n| # | Idea | Quietude note |\\n|---|---|---|\\n| 56 | Reseller Programs | Corporate wellness platforms (Modern Health, Lyra) as resellers |\\n| 67 | Roadshows | Quietude Experiences IS this — eye mask + listening session pop-ups in 3 cities |\\n| 71 | Conferences | Quietude-hosted \\\"Sound + the Body\\\" — long-game category-defining moment |\\n| 76 | Documentaries | Alex's story is documentary-grade — long game |\\n| 77 | Black Friday Promotions | Holiday eye mask + Premium bundle |\\n| 80 | New Year Promotions | New Year nervous system reset campaign |\\n| 84 | Giveaways | Eye mask giveaway with brand partner (Wellness Mama tier) |\\n| 85 | Vacation Giveaways | Quietude + retreat partner giveaway (quietude.center could be venue) |\\n| 87 | Powered By Marketing | \\\"Sound system by Quietude\\\" badge in B2B venue installs |\\n| 104 | Book Marketing | Sound Philosophy as a book — long-game positioning anchor |\\n| 105 | Annual Reports | \\\"State of the Nervous System\\\" — Quietude's data + industry commentary |\\n| 106 | End of Year Wraps | \\\"Your nervous system year\\\" — Spotify Wrapped equivalent |\\n| 110 | Awards as Marketing | Quietude founds an award for innovative biophilic acoustic design |\\n| 116 | Grants as Marketing | Free Quietude subscriptions for therapists, social workers, first responders |\\n| 119 | OOH Advertising | SF / NYC billboards if Series A budget unlocks |\\n| 120 | Marketing Stunts | Public sound installation could work — brand-fitting |\\n| 121 | Guerrilla Marketing | Sound installation in subway / airport — interesting but requires care |\\n| 131 | International Expansion | Finland HQ + global ICP — Q4 or post-Series A |\\n\\n**Skip / off-brand for Quietude:**\\n\\n| # | Idea | Why skip |\\n|---|---|---|\\n| 16 | Importers as Marketing | No competitor data to import (consumer wellness, not SaaS) |\\n| 19 | Chrome Extensions | Off-platform (mobile-first product) |\\n| 21 | Scanners | No obvious product fit |\\n| 22 | Public APIs | Not core business |\\n| 27 | Twitter Ads | Lower priority unless Alex's X presence grows |\\n| 34 | Click-to-Messenger Ads | Off-brand (no DM-driven sales pattern) |\\n| 41 | X Audience | Depends on Alex's bandwidth — defer unless he wants to |\\n| 43 | Engagement Pods | Off-brand |\\n| 73 | Media Acquisitions | Too capital-intensive at this stage |\\n| 83 | Twitter Giveaways | Off-brand voice |\\n| 86 | Lifetime Deals | Brand-conflict — pressures the \\\"no pressure\\\" voice and damages LTV math |\\n| 88 | Free Migrations | No competitor data to migrate |\\n| 89 | Contract Buyouts | Not relevant for D2C subs |\\n| 99 | Graphic Novel Marketing | Off-brand |\\n| 112 | Reality TV Marketing | Off-brand |\\n| 117 | Product Competitions | Not a developer product |\\n| 118 | Cameo Marketing | Off-brand |\\n| 122 | Humor Marketing | Brand voice is serious; humor would feel off |\\n| 123 | Open Source as Marketing | Proprietary audio library |\\n| 125 | App Marketplaces | Not relevant for native consumer app (no app-of-app pattern) |\\n| 128 | Source Platforms | G2 / Capterra are B2B-focused; D2C uses App Store reviews |\\n| 132 | Price Localization | Q4+ — tied to international expansion |\\n| 136 | Developer Relations | Not a dev product |\\n\\n### 12.2 Activation ideas (7 mapped)\\n\\n| # | Idea | Status | Quietude note |\\n|---|---|---|---|\\n| 124 | App Store Optimization | Now | Q1 priority — listing rewrite in voice (also Acquisition) |\\n| 90 | One-Click Registration | Now | OAuth (Apple, Google) for app signup — standard activation lift |\\n| 51 | Onboarding Emails | Q2 | Flow 2 — held until UI stable post-onboarding-rebuild |\\n| 96 | Onboarding Optimization | Q1-Q2 | The 3-variant test IS this — primary activation work |\\n| 47 | Founder Welcome Email | Q2 | Personal welcome from Alex or Sam early in Flow 2 |\\n| 48 | Dynamic Email Capture | Q2 | Smart capture on `quietude.app` — exit intent + scroll depth |\\n| 95 | Concierge Setup | Q3+ | High-touch onboarding for B2B venue clients + high-value subscribers |\\n\\n### 12.3 Retention ideas (8 mapped)\\n\\n| # | Idea | Status | Quietude note |\\n|---|---|---|---|\\n| 46 | Reactivation Emails | Now | Flow 4 ships in weeks 3–4 — exactly this |\\n| 52 | Win-back Emails | Q1 (week 11-12) | Standalone campaign on top of Flow 4 |\\n| 53 | Trial Reactivation | Q2 | Expired-trial recovery campaign once paywall is firing |\\n| 45 | Mistake Email Marketing | Q2 | When something genuinely goes wrong, send \\\"oops\\\" — drives engagement |\\n| 50 | Inbox Placement | Q1 | Subdomain silo strategy (`mail.quietude.app` / `commerce.quietude.app`) addresses this |\\n| 91 | In-App Upsells | Q2 | Premium upsell points within app (also Revenue) |\\n| 94 | Offboarding Flows | Q2 | Optimize cancellation flow to retain or learn — feeds churn intel |\\n| 135 | Support as Marketing | Q2 | Customer support stories surface as content (also Acquisition) |\\n\\n### 12.4 Referral ideas (5 mapped)\\n\\n| # | Idea | Status | Quietude note |\\n|---|---|---|---|\\n| 62 | Affiliate Program | Now | Ambassador program v1 is exactly this — launched with the 5 inbound |\\n| 137 | Two-Sided Referrals | Q2 | Reward both referrer and referred — share-after-shift moment + gifting flow |\\n| 92 | Newsletter Referrals | Q3 | If we launch a newsletter, Sparkloop-style referral mechanic |\\n| 93 | Viral Loops | Q3 | Built-in share mechanics post-Mira reflection |\\n| 79 | Early-Access Referrals | Q3 | App GA early-access list referrals (cross-references to Acquisition) |\\n\\n### 12.5 Revenue ideas (3 mapped — most ideas serve top-of-funnel)\\n\\n| # | Idea | Status | Quietude note |\\n|---|---|---|---|\\n| 91 | In-App Upsells | Q2 | Premium upgrade prompts; eye mask cross-sell from app (also Retention) |\\n| 132 | Price Localization | Q4+ | Adjust pricing for local purchasing power once international |\\n| 86 | Lifetime Deals | Skip | Brand-conflict — see Acquisition skip list |\\n\\n### 12.6 Cross-cutting / brand foundation ideas\\n\\n| # | Idea | Status | Quietude note |\\n|---|---|---|---|\\n| 139 | Customer Language | Now | Mira reflection responses + 7 Ds language = the source-of-truth for customer language across all copy |\\n| 114 | Moneyball Marketing | Ongoing | Find undervalued channels at every stage — methodology, not a single tactic |\\n\\n### Idea-bank summary\\n\\n- **88 ideas applicable to Acquisition** (the dominant stage at Quietude's current stage — makes sense, Quietude's product converts well; the bottleneck is the top of funnel)\\n- **7 ideas to Activation, 8 to Retention** (smaller because these stages are about depth, not breadth — execute the right few well rather than running a wide tactic menu)\\n- **5 ideas to Referral** (program-driven, not tactic-driven)\\n- **3 ideas to Revenue** (most revenue work is pricing strategy, not tactical tricks)\\n- **2 cross-cutting**\\n- **23 ideas skipped for brand / business-model fit** — Quietude's category positioning constrains what's available\\n\\n**What this proves:** the plan is roughly 30% of the available tactical surface area, not 100%. That's appropriate at this stage and budget. As capacity unlocks across Q2 → Q3 → Series A, the cross-reference becomes the inventory we pull from to scale activity without losing strategic coherence.\\n\\n---\\n\\n## 13. Measurement, RACI, open decisions, appendix\\n\\n### Measurement — the metrics that matter\\n\\n**North star (proposed):**\\n**Blended-LTV-to-blended-CAC ratio per acquired user**, where:\\n- Blended LTV combines app subscription revenue + hardware revenue (eye mask + speakers) + any cross-sells, per cohort\\n- Blended CAC combines paid spend + content production cost + ambassador commissions + lifecycle tool spend, per cohort\\n\\nThis captures the business model: the eye mask wedge isn't free if it costs $X to make, and the app sub isn't expensive to acquire if a Bryan-Johnson-style PR moment is paying for itself.\\n\\nIf a single metric is preferred for team-level focus, fall back to: **monthly new D2C subscribers from non-paid channels.** This isolates the compound channels the long-game strategy depends on.\\n\\n**Leading indicators by AARRR stage:**\\n\\n| Stage | Leading indicators |\\n|---|---|\\n| Acquisition | Organic visits/mo (overall + per pillar), App Store visit-to-install rate, Alex's LinkedIn engagement → email subscribers, event-to-app conversion rate, ambassador-attributed visits |\\n| Activation | Day 1 / Day 7 / Day 35 → paid conversion, onboarding session-completion rate, first session Mira reflection completion |\\n| Retention | 30 / 60 / 90-day retention, monthly churn, Flow 4 reactivation rate, hardware → app activation rate |\\n| Referral | Ambassador-attributed new subs (Dub), share-after-shift rate, Guides pilot referrals (when live) |\\n| Revenue | Blended MRR, ARPU, annual plan adoption %, LTV by cohort, eye mask attach rate |\\n\\n**Review cadence:**\\n- **Weekly:** fCMO ↔ Alex 30-min sync. AARRR scoreboard + this week's ships.\\n- **Monthly:** Full metrics review (extended sync, Sam included). Compare against quarterly KPI targets.\\n- **Quarterly:** Plan recalibration. What's working, what's not, what funding-stage moves we're triggering.\\n\\n### RACI\\n\\n| Domain | Responsible | Accountable | Consulted | Informed |\\n|---|---|---|---|---|\\n| Strategic plan (this doc) | Casey | Alex | Sam, Emily | Team |\\n| Brand voice | Alex + Sam | Alex + Sam | Casey | Team |\\n| App + onboarding implementation | Devon | Alex | Casey | Team |\\n| Lifecycle flows (Customer.io) | Casey | Alex | Sam (copy QA) | Team |\\n| SEO content | Casey | Casey | Sam, Alex | Team |\\n| App Store copy | Casey | Alex | Sam | Team |\\n| Alex's LinkedIn cadence | Alex | Alex | Casey (orchestration) | Team |\\n| Events | Alex + Sam | Alex | Casey (instrumentation only) | Team |\\n| Ambassador program | Casey | Casey | Alex | Team |\\n| B2B sales | Alex | Alex | Casey (case studies) | Team |\\n| Pricing | Alex | Alex | Casey | Sam |\\n| Investor narrative | Alex | Alex | Casey, Sam | Team |\\n| Quietude Guides program (Q3+) | TBD (likely future hire) | Alex + Sam | Casey | Team |\\n| Future marketing hire (Q3) | Casey | Alex | Sam | Team |\\n\\n### Open decisions blocking the plan\\n\\nMost blocking, ranked by impact:\\n\\n1. **Canonical domain.** SEO data + this plan recommend `quietude.app`. Needs exec sign-off + 301 execution plan. *Blocks: domain consolidation, SEO foundation, email sender migration.*\\n2. **Retention metric definition.** Reconcile 38% 12-month retention claim vs. 29% monthly App Store churn. *Blocks: clean dashboards, investor narrative coherence, lifecycle test reads.*\\n3. **Mira post-session reflection scope.** Does Mira currently support this, or is it new build? *Blocks: Onboarding Variants 1 and 2 (which depend on Mira reflection moment), retention compound moves.*\\n4. **App UI stability timeline.** When does the headphone-gate-removal + onboarding-rebuild allow Flow 2 to ship without rework risk? *Blocks: Flow 2, full lifecycle, paid acquisition timing.*\\n5. **GA launch timeline.** When does the throttled beta become GA? *Blocks: paid acquisition scale, Q3 GTM planning.*\\n6. **Pricing structure ground truth.** What's actually charged today? *Blocks: pricing audit conclusions, annual-plan default test, blended LTV math.*\\n7. **First marketing hire scope.** Lifecycle + content owner, or something else? When does the JD get written? *Blocks: Q3 capacity plan, succession of fCMO operational work.*\\n8. **Ambassador commission structure.** $/sub, rev-share, hybrid? *Blocks: ambassador program launch, attribution dashboards.*\\n\\n### Appendix — deep-dive links\\n\\n**Published to the team via `Quietude-Inc/quietude-context` GitHub repo:**\\n- `marketing/seo/plan.md` — Full 90-day SEO + keyword research plan\\n- `marketing/seo/keyword-shortlist.md` — Tier 1 keyword shortlist\\n- `marketing/seo/raw/` — Ahrefs + DataForSEO API pulls\\n- `marketing/onboarding-recommendation.md` — Three-variant onboarding test plan\\n\\n**Founder-authored strategic context** (in Quietude's internal knowledge base):\\n- Seed deck — Investor narrative\\n- Sound Philosophy — Alex's technical/philosophical working doc\\n- Marketing OS — Brand voice, content rhythm, visual system\\n- ICP doc — D2C audience profile\\n- Meditation-vs-Regulation note (2026-05-19) — Central content pillar\\n- Kickoff call transcript (2026-05-18) — Decisions + open questions\\n- App Store copy snapshot + voice-gap analysis\\n- App Store metrics snapshot (2026-05-16)\\n- Customer.io lifecycle flows inventory\\n\\n---\\n\\n*Marketing Plan v1. Prepared by Casey Reed (fCMO), 2026-05-27. For team review and discussion.*\\n\"}\n];\n",[],[463,774,766],"refs","fe3860be-5d6d-11f1-b1be-1607ee4eb77e","ref_8.ts","fe386168-5d6d-11f1-b1be-1607ee4eb77e",667,["D",1780286242301],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_8: SkillRef[] = [\n {\"skill\":\"marketing-plan\",\"ref\":\"aarrr-framework\",\"body\":\"# AARRR Framework — Primer for Plan Sequencing\\n\\nAARRR (Dave McClure's \\\"pirate metrics\\\") is the spine of every plan produced by this skill. This doc is the primer + the decision rules for when each stage gets prioritized.\\n\\n## The five stages\\n\\n| Stage | Question | Common metrics |\\n|---|---|---|\\n| **A**cquisition | How do strangers become aware of us? | Visits, MQLs, signup-page sessions, app-store visits, CAC by channel |\\n| **A**ctivation | Once they try us, do they have an experience that converts? | Signup completion rate, time-to-value, % completing first key action, trial → paid rate |\\n| **R**etention | Do they stay and deepen? | DAU/WAU/MAU, week-1/4/12 retention, churn |\\n| **R**eferral | Do retained users bring more users? | Viral coefficient, NPS, ambassador attribution |\\n| **R**evenue | What do they pay, who pays, how does it compound? | ARPU, LTV, expansion revenue, ARR / MRR |\\n\\n> **Signup boundary rule.** Signup *intent* (a stranger landing on the signup page) is Acquisition. Signup *completion* and everything after (first key action, trial-to-paid) is Activation. Apply this rule consistently across all docs and the plan template.\\n\\n## Why AARRR for plan sequencing\\n\\nThree reasons.\\n\\n**1. Funnel-stage tagging forces prioritization.** Without AARRR, marketing plans become channel-organized (\\\"here's the SEO plan, here's the social plan, here's the paid plan\\\"). Channels can address multiple stages; tagging by stage instead asks the more useful question: *what stage of the funnel is the binding constraint right now?*\\n\\n**2. Fix the leak before pouring water in.** The Activation/Retention question (\\\"does the funnel convert at acceptable rates given exposure?\\\") is usually higher leverage than the Acquisition question (\\\"how do we get more exposure?\\\"). AARRR sequencing surfaces this naturally.\\n\\n**3. The Revenue / Referral conversation is honest.** Most marketing plans bury monetization under \\\"growth\\\" and treat referral as wishful thinking. AARRR forces explicit treatment of both.\\n\\n## Brand and content — not a stage, cross-cutting\\n\\nA common mistake: making \\\"Brand\\\" or \\\"Content\\\" the sixth bucket. They're not — they serve every stage.\\n\\n- **Brand voice** governs every piece of copy across every stage\\n- **Content** feeds Acquisition (SEO, social), Activation (onboarding copy), Retention (email lifecycle), Referral (ambassador talking points), Revenue (pricing pages, sales material)\\n\\nIn the plan, brand/content shows up as the strategic frame (Section 2) and cross-cutting in Section 11's ops stack — never as its own AARRR section.\\n\\n## Diagnosing the binding constraint — which AARRR stage is highest leverage?\\n\\nFor every client, one or two AARRR stages will be the binding constraint. The plan sequences moves there first.\\n\\n**Decision rules:**\\n\\n### If you don't have any users → start with Acquisition\\n- Pre-launch / day-0 / waitlist stage\\n- No funnel data exists\\n- Leverage = building the first 100 users\\n\\n### If you have users but they bounce → start with Activation\\n- Signups happen but activation rate is low\\n- App Store conversion is poor\\n- Onboarding completion is broken\\n- Day 1 → paid rate is much lower than Day 30 → paid (means product converts given time but onboarding doesn't bridge to it)\\n- Leverage = bridging signup to first felt value\\n\\n### If activation works but users churn → start with Retention\\n- Month 1 retention is below category norms\\n- Activated users stop using within 7–14 days\\n- LTV is short\\n- Leverage = lifecycle, deepening engagement, churn prevention\\n\\n### If retention is strong but growth is slow → start with Referral / Revenue\\n- Retained users love the product but don't share\\n- Inbound referrals come in unstructured\\n- Pricing hasn't been pressure-tested\\n- ARPU is low for the value delivered\\n- Leverage = WOM mechanics + pricing optimization (these often cluster)\\n\\n### If everything works at small scale → start with Acquisition (scaling)\\n- Funnel is healthy\\n- Question is just \\\"more\\\"\\n- This is the \\\"post-fit\\\" scaling problem\\n\\n## Stage-by-stage strategic patterns\\n\\n### Acquisition\\n\\n**The diagnostic question:** Where is the gap between TAM-level awareness and current funnel volume? What channels are saturated by competitors vs. open?\\n\\n**Common Acquisition moves:**\\n- SEO content strategy (organic compounding)\\n- Founder-led channels (LinkedIn, X, Substack for B2B; Instagram/TikTok for D2C)\\n- Paid acquisition (when budget unlocks)\\n- App Store / Play Store / marketplace listing optimization\\n- PR and credibility-anchor amplification\\n- Events (live, webinar, conference speaking)\\n- Partnerships (newsletter swaps, integration co-marketing, reseller / agency partners)\\n- Hardware / commerce surface (Shopify SEO + Amazon for hybrid businesses)\\n- B2B sales support (case studies, partner pages, vertical content)\\n\\n**Sequencing principle:** Build the organic compound first (SEO + founder-led + content + PR amplification + ambassadors). Only layer paid on top of a working organic baseline. Premature paid amplifies what's broken.\\n\\n### Activation\\n\\n**The diagnostic question:** Where in the user's first session do they decide \\\"this works for me\\\" or \\\"this doesn't\\\"? What stops them from reaching that moment?\\n\\n**Common Activation moves:**\\n- Bedrock fixes (broken gates, broken signup steps, broken paywall)\\n- Onboarding tests / rebuild (often the most leveraged single move)\\n- App Store listing rewrite (the threshold to the trial)\\n- Lifecycle Flow ship order (when to ship onboarding emails)\\n- Paywall structure + trial length\\n- Free → paid bridge (in-app upsells, soft paywalls)\\n\\n**Sequencing principle:** Get to first felt value as fast as possible. Everything that adds friction between \\\"user opens app\\\" and \\\"user has the experience that converts them\\\" is a candidate to cut.\\n\\n### Retention\\n\\n**The diagnostic question:** Why do users churn? What would have made them stay? What's the \\\"second moment of value\\\" after the first one?\\n\\n**Common Retention moves:**\\n- Lifecycle email flows: onboarding, lapsed user re-engagement, post-purchase, win-back\\n- Subscription / preference centers\\n- Churn reconciliation (often metric definitions don't match across surfaces)\\n- Hardware → software activation paths (for hybrid businesses)\\n- Annual plan defaults / pricing structure (cross-cuts Revenue)\\n- Support as marketing (high-touch moments that drive stories)\\n- Community + practitioner networks\\n\\n**Sequencing principle:** Ship lifecycle flows in the order their content is most stable. Hardware post-purchase flows ship first (they don't reference in-app screens that might change). Onboarding emails ship last (they reference UI that might change). Win-back is a quarterly campaign, not a one-time flow.\\n\\n### Referral\\n\\n**The diagnostic question:** Is there inbound referral interest that isn't being captured? What's the share-after-value moment that's natural to the product?\\n\\n**Common Referral moves:**\\n- Ambassador / affiliate program (start with inbound interest, not cold recruitment)\\n- Share-after-value moments built into the product (reflection prompts, milestone celebrations)\\n- Founder amplification (founder as referrer-zero)\\n- Long-game expert / Guides / certified-host networks (for category-creating businesses)\\n- Gifting flows (consumer / hardware)\\n- Two-sided referrals (reward both referrer and referred)\\n\\n**Sequencing principle:** Lead with whoever is already raising their hand. If there are 5 inbound ambassadors, launch with those 5 — don't wait for a \\\"complete program.\\\" Iterate based on what they tell you.\\n\\n### Revenue\\n\\n**The diagnostic question:** Is the company underpricing? Underpackaging? Missing an upsell? What's the \\\"right\\\" price discipline given LTV and brand voice?\\n\\n**Common Revenue moves:**\\n- Pricing audit (what's actually charged today vs. listed?)\\n- Annual plan defaults\\n- Hardware → software bundling formalization\\n- Storefront / commerce page optimization\\n- B2B case studies + sales material\\n- Long-term value pool flags (data, expansion, enterprise) — flagged not executed\\n\\n**Sequencing principle:** Run the pricing audit before testing changes. Surprisingly often, the \\\"implied\\\" pricing on the dashboard doesn't match the listed price — discounts, trials, or plan mix distorts the read. Surface the ground truth first.\\n\\n## How to assign a move to a stage\\n\\nSome moves clearly belong to one stage. Others span. The rule:\\n\\n**Assign to the stage where the move's primary measurable impact lands.**\\n\\nExamples:\\n- \\\"Rewrite App Store listing in voice\\\" — spans Acquisition (organic discovery) and Activation (threshold to trial). Primary impact = Activation (trial conversion rate). Assign to Activation, mention crossover.\\n- \\\"Eye mask Shopify page rewrite\\\" — spans Acquisition (organic search for sleep mask) and Revenue (sale conversion). Primary impact = Revenue (transaction). Assign to Revenue, mention crossover.\\n- \\\"Alex's LinkedIn cadence\\\" — Acquisition (top of funnel for D2C subscribers).\\n- \\\"Customer.io Flow 6 (eye mask post-purchase)\\\" — Retention (deepens hardware buyer engagement) with crossover to Activation (hardware → app premium activation path).\\n\\nWhen in doubt: where would removing this move hurt the most? Assign there.\\n\\n## When the AARRR breakdown isn't equal\\n\\nFor most clients, the plan won't have equal volume across stages. That's fine — and worth surfacing as a diagnostic.\\n\\n- **Heavy Acquisition section** = client has product-market fit but top-of-funnel is the bottleneck. Common for early-stage with strong retention metrics.\\n- **Heavy Activation section** = client has traffic but conversion is broken. Often beta-stage products.\\n- **Heavy Retention section** = client has churn problem. Often mid-stage products that scaled past PMF without lifecycle infrastructure.\\n- **Heavy Referral section** = client has loyalty but no WOM mechanics. Often consumer products with passionate users.\\n- **Heavy Revenue section** = client is underpricing or missing monetization layers. Common for tools transitioning from free to paid.\\n\\nIf a plan ends up evenly distributed across all five stages, the diagnostic was probably weak — re-examine the funnel state intake to find where the binding constraint is.\\n\\n## A note on the order of presentation\\n\\nAlways present AARRR in order (Acquisition → Activation → Retention → Referral → Revenue) regardless of priority order.\\n\\nThis is for the reader's mental model. Founders expect the funnel to flow top-to-bottom. If Retention is the most-leveraged stage but you lead with Retention, the reader has to context-switch.\\n\\nTo signal priority, use the executive summary (Section 1) — name the biggest bets there. The AARRR breakdown then walks the funnel in order, with the most leverage-positive section being the longest and most-detailed.\\n\"},\n {\"skill\":\"marketing-plan\",\"ref\":\"budget-planning\",\"body\":\"# Budget Planning — Scientific Methods for Setting the Marketing Budget\\n\\nThe problem with most SaaS marketing budgets is that they're pulled out of thin air — a number that hopefully doesn't constrain growth too much, but doesn't anchor in customer-acquisition economics either. The result: when someone asks \\\"why this number?\\\" there's no answer.\\n\\nTwo scientific methods solve this. Use one (not both) in Section 8 (Revenue) and Section 10 (12-month outlook) of every plan.\\n\\nExcerpted and adapted from *Founding Marketing* by Corey Haines.\\n\\n## Method 1 — Revenue-Based (5–40% of annual revenue)\\n\\n**Direction:** budget → revenue goal.\\n\\nYou start with what the company can comfortably spend on marketing, then forecast what revenue that spend can plausibly generate.\\n\\n### The ranges\\n\\n| Posture | % of ARR | When to use |\\n|---|---|---|\\n| **Conservative (profit-preserving)** | 5% | Established business focused on profit distribution; bootstrapped; founder-paid customer base |\\n| **Standard growth** | 15–25% | Most healthy SaaS in the seed-to-Series-A range |\\n| **Aggressive growth (deploying raised capital)** | up to 40% | Recently funded round, mandate to deploy fast, board accepts burn |\\n\\nFor reference: public SaaS companies routinely report sales-and-marketing spend between 20% and 55% of revenue (Zoom historically ran between 20% and 55% across years).\\n\\n### The math (Conservative example)\\n\\nBusiness at $1M ARR, 5% allocation:\\n\\n- Annual marketing budget: **$50,000**\\n- Blended CAC: $100 → can acquire **500 new customers**\\n- ARPC: $50/mo → adds **$300K** to ARR\\n- Account for 15% annual churn → 85% × $300K = **+$255K net new ARR**\\n- End-of-year goal: **$1.255M ARR**\\n\\n### The math (Aggressive example)\\n\\nBusiness at $1M ARR, 40% allocation:\\n\\n- Annual marketing budget: **$400,000**\\n- Blended CAC: $100 → can acquire **4,000 new customers**\\n- ARPC: $50/mo → adds **$2.4M** to ARR\\n- End-of-year goal: **$3.4M ARR**\\n\\n### Two keys to making this method work\\n\\n1. **Know your blended CAC** (see \\\"Calculating CAC\\\" below)\\n2. **Match the allocation percentage to your actual ambition.** A founder running 5% allocation while telling the board they expect to triple revenue is showing two incompatible signals.\\n\\n## Method 2 — Goal-Based (reverse-engineered from the revenue target)\\n\\n**Direction:** revenue goal → budget.\\n\\nYou start with the revenue goal and work backward through the unit economics to derive the budget required to hit it. Best for:\\n\\n- Companies just starting up (no historical CAC baseline yet, working from first principles)\\n- Companies anticipating outside capital (need to defend the ask)\\n- Companies using revenue-based financing (Pipe, Capchase, Founderpath)\\n\\n### The formula\\n\\n```\\nMarketing budget = [(New ARR / (ARPC × 12)) × CAC] / annual retention rate\\n```\\n\\n### Worked example: $1M ARR → $2M ARR\\n\\nStep 1 — How much new ARR per customer?\\nARPC × 12 = $50 × 12 = **$600 ARR per new customer**\\n\\nStep 2 — How many new customers do we need?\\n$1,000,000 / $600 = **1,667 new customers**\\n\\nStep 3 — What's the raw acquisition cost?\\n1,667 × $100 CAC = **$166,700**\\n\\nStep 4 — Account for churn (15% annual = 85% retention)\\n$166,700 / 0.85 = **$196,118** (round to **$200K**)\\n\\nWhen someone asks how you got to the budget, walk them through the four steps. It's defensible.\\n\\n### Why this formula and not something simpler\\n\\nThe four steps each correspond to a real economic reality:\\n- Step 1 converts MRR-language into the ARR-language a board talks in\\n- Step 2 names the customer count, which is what the funnel actually has to deliver\\n- Step 3 anchors the budget in the cost of acquisition\\n- Step 4 acknowledges that churned customers don't count toward net new ARR, so the budget needs to cover the gap\\n\\n### Required buffer\\n\\n**Always add 10–20% as \\\"experimental budget\\\"** on top of the formula output. CAC is the main dependency; if CAC comes in 50% higher than estimated, the cascading effect is missing the revenue goal. It is much cheaper to overestimate CAC than to underestimate it.\\n\\nThe experimental budget also funds the experiments that find your next channel before your current one plateaus (see `growth-patterns.md` — channel S-curves).\\n\\n## The VC growth path (3-3-2-2-2 rule)\\n\\nOnce a company has crossed $1M ARR and taken a Series A, the implicit benchmark VCs expect is:\\n\\n| Year | ARR multiple | Cumulative ARR (from $1M start) |\\n|---|---|---|\\n| Year 0 | — | $1M |\\n| Year +1 | 3× | $3M |\\n| Year +2 | 3× | $9M |\\n| Year +3 | 2× | $18M |\\n| Year +4 | 2× | $36M |\\n| Year +5 | 2× | $72M |\\n| Year +6 | 2× | $144M |\\n| Year +7 | 2× | $288M |\\n\\nThat's the 3-3-2-2-2 rule. Useful when:\\n\\n- The plan needs to map 12-month and 36-month milestones to VC expectations\\n- The founder is mid-raise and the board needs to see a plausible path to the next round\\n- Section 10 (12-month outlook) needs anchoring against an industry benchmark, not just internal ambition\\n\\nMost companies miss it. That's fine. Knowing the benchmark gives the team a defensible reason to either match it or explicitly choose not to.\\n\\n## Calculating CAC (blended, not paid-only)\\n\\nIf there's no historical CAC, use a baseline: **one year of revenue from the smallest paid plan.** Deploy the budget, capture actual CAC data, replace the baseline with the measured number for the next planning cycle.\\n\\nFor an established CAC calculation, **CAC must be blended.** Include:\\n\\n- Marketing salaries (full loaded cost, not just base)\\n- Advertising spend\\n- Marketing tech stack costs\\n- Content production costs (writers, designers, video editors)\\n- Agency / contractor retainers\\n- SDR / BDR salaries if doing outbound\\n- Tools (CRM, marketing automation, analytics)\\n\\nThen divide by the number of new customers acquired in the period. That blended number is the one to use in either budgeting method.\\n\\nThe mistake to avoid: calculating CAC from paid ad spend alone. A company that \\\"doesn't run ads\\\" still has a CAC — it's just hidden in the content team, the founder's time, the SEO contractor, the conference booth.\\n\\n## The reality check on forecasting\\n\\nThis whole framework derives a budget and a revenue goal — not a 12-month month-by-month forecast accurate to the dollar.\\n\\n**Unless the company is publicly traded, all forecasts are educated guesses.** No startup under $100M ARR reliably hits forecasts to the month. The honest framing for the plan:\\n\\n- The annual goal is a defensible direction-of-travel\\n- The budget is the resource commitment that makes the goal plausible\\n- The 90-day roadmap (Section 9) is what's actionable now\\n- Month-to-month variance is expected; quarterly review is when the plan adjusts\\n\\nWhat's actionable: how to deploy the budget, what concrete moves to execute, what to adjust when real data comes in.\\n\\nWhat's not actionable: trying to forecast traffic, pipeline, retention curves, conversion rates, and channel mix all down to the decimal point and expecting that forecast to hold. Founders who over-engineer the forecast tend to spend the plan period explaining variance instead of executing.\\n\\n**Rule for the plan:** the budget number is honest. The annual goal is honest. The month-by-month projection is illustrative.\\n\\n## How this flows into the plan\\n\\n| Section | What to include |\\n|---|---|\\n| **3 (Current state)** | Current monthly marketing spend broken down by line (paid, tools, content, headcount, retainers). Compute current %-of-ARR allocation. |\\n| **8 (Revenue)** | The unit-economics table (CAC, ARPC, churn) that feeds whichever budget method you're using. |\\n| **10 (12-month outlook)** | Apply Method 1 or Method 2 to derive the 12-month budget and the resulting revenue goal. Anchor against the 3-3-2-2-2 rule if Series A+ and VC-backed. |\\n| **11 (Ops stack)** | Show the budget allocation across the AARRR stages — what % to Acquisition, Activation, etc. The ops-stack mapping informs which line items grow when the next funding tier unlocks. |\\n| **13 (Open decisions)** | If CAC is unknown or contested, flag it as the highest-impact open decision — every other number depends on it. |\\n\\n## When to choose which method\\n\\n- **Method 1 (Revenue-Based)** when the company has historical CAC data, a profit/burn posture, and the question is \\\"given our posture, what's a plausible goal.\\\"\\n- **Method 2 (Goal-Based)** when the company has a specific goal (board mandate, VC milestone, fundraise target) and the question is \\\"what budget do we need to hit it.\\\"\\n\\nFor most plans in the seed-to-Series-A range, Method 2 is more useful — it forces the conversation about whether the goal is funded.\\n\"},\n {\"skill\":\"marketing-plan\",\"ref\":\"client-types\",\"body\":\"# Client Types — Variations by Business Model\\n\\nThe 13-section plan structure stays consistent across client types. What changes is the **content emphasis** within each section. This doc names the dominant patterns by client archetype.\\n\\n## Archetype 1 — B2B SaaS\\n\\n### Core characteristics\\n- Subscription revenue\\n- Often higher ACV ($1K–$100K+ per year)\\n- Sales-assisted or self-serve depending on tier\\n- Buyer often different from user (champion vs. end-user)\\n\\n### AARRR emphasis\\n\\n**Acquisition heavy:**\\n- SEO is the dominant top-of-funnel motion (people search for solutions)\\n- Content marketing (blog, knowledge base, comparison pages) drives MQLs\\n- LinkedIn for both organic founder presence and paid\\n- Outbound (cold email + LinkedIn) often complements inbound\\n- Events (conferences, webinars) for high-ACV products\\n\\n**Activation:**\\n- Signup → trial → first key action (PLG products)\\n- Trial → demo → POC (sales-led products)\\n- Empty states matter — guide users to first value action\\n\\n**Retention:**\\n- Product engagement metrics (DAU, feature adoption)\\n- Customer success motion (CSM team for higher ACV)\\n- Lifecycle emails focused on feature discovery, value moments\\n\\n**Referral:**\\n- Customer advocacy programs\\n- Partner / integration co-marketing\\n- G2 / Capterra reviews\\n- Champion-to-buyer expansion\\n\\n**Revenue:**\\n- Expansion / NRR is often the biggest growth lever\\n- Tier upgrades, seat expansion, usage-based add-ons\\n\\n### Skills emphasis\\n- `cold-email`, `programmatic-seo`, `competitors`, `seo-audit`, `ai-seo`\\n- `ads` weighted toward LinkedIn + Google\\n- `emails` for trial nurture + lifecycle\\n- `pricing` for tier optimization\\n\\n### Tier-1 budget priority\\n- SEO + content > everything else\\n- Founder-led LinkedIn channel\\n- Customer.io / Mailchimp for nurture\\n- HARO + investor backchannel for PR\\n\\n---\\n\\n## Archetype 2 — D2C Consumer App (Subscription)\\n\\n### Core characteristics\\n- Lower ACV ($5–$30/mo typically)\\n- High volume, lower margin per user\\n- App Store / Play Store as the primary acquisition surface\\n- Lifecycle email + push for retention\\n- Often paid-acquisition-driven once budget unlocks\\n\\n### AARRR emphasis\\n\\n**Acquisition:**\\n- App Store Optimization (ASO) is the highest-leverage non-site asset\\n- Paid social (Meta, TikTok) often dominant once budget exists\\n- Apple Search Ads for high-intent App Store traffic\\n- Influencer + content creators\\n- PR + endorsements\\n\\n**Activation:**\\n- Onboarding is the dominant activation surface\\n- Time-to-value must be minutes, not hours\\n- Paywall structure + trial length critical\\n\\n**Retention:**\\n- Lifecycle email + push\\n- In-app reminders (carefully — overuse = churn)\\n- Subscription preference center\\n- Win-back campaigns\\n\\n**Referral:**\\n- Built-in sharing (share-a-month flow)\\n- Two-sided referrals\\n- Influencer / creator ambassadors\\n\\n**Revenue:**\\n- Annual plan default is the biggest single move (compresses MRR but improves LTV)\\n- Tier optimization (Free → Premium → Premium+)\\n- In-app upsells\\n\\n### Skills emphasis\\n- `onboarding`, `paywalls`, `emails`\\n- `ads`, `ad-creative` (heavy creative iteration)\\n- `referrals`\\n- `pricing` for annual default + tier consolidation\\n\\n### Tier-1 budget priority\\n- ASO first (highest organic leverage)\\n- Onboarding rebuild\\n- Lifecycle email shipping\\n- Founder-led social if founder is on-camera\\n\\n---\\n\\n## Archetype 3 — Hybrid Hardware + Software\\n\\n### Core characteristics\\n- Physical product + software companion (e.g., Quietude's eye mask + app)\\n- Hardware as a distribution wedge (lower price, easier first purchase)\\n- Software as the LTV (recurring revenue)\\n- Blended CAC across both surfaces\\n\\n### AARRR emphasis\\n\\n**Acquisition:**\\n- Shopify storefront SEO (hardware product pages target consumer search)\\n- Amazon listing (high-discovery, takes margin)\\n- PR amplification (hardware is photogenic — high-profile influencer endorsements move volume)\\n- Paid social for hardware (Meta + Instagram, eye-catching creative)\\n\\n**Activation:**\\n- Two activations to track: hardware unboxing experience + software signup\\n- Hardware → software activation flow is the bridge\\n- Concierge setup for high-value hardware buyers\\n\\n**Retention:**\\n- Hardware post-purchase lifecycle (different from app onboarding)\\n- Software companion drives stickiness\\n- Community / practitioner network around hardware\\n\\n**Referral:**\\n- Hardware gifting flows (high WOM for physical products)\\n- Eye-catching hardware drives organic social sharing\\n- Reviews on Shopify + Amazon\\n\\n**Revenue:**\\n- Blended LTV math is critical (hardware margin + software recurring)\\n- Bundle strategy (hardware buy → free Premium for X months)\\n- Annual plan default for software\\n\\n### Skills emphasis\\n- `seo-audit` for Shopify product pages\\n- `emails` for both hardware post-purchase and software lifecycle\\n- `referrals` with gifting layer\\n- `pricing` for blended-bundle math\\n- `ads` with creative-heavy Meta presence\\n\\n### Tier-1 budget priority\\n- Shopify product page optimization\\n- Hardware post-purchase lifecycle ship\\n- Bundle strategy formalization\\n- Hardware → app activation audit\\n\\n---\\n\\n## Archetype 4 — Marketplace\\n\\n### Core characteristics\\n- Two-sided product (supply + demand)\\n- Network effects matter\\n- Liquidity is the critical early metric\\n- Take-rate × GMV is the revenue model\\n\\n### AARRR emphasis\\n\\n**Acquisition:**\\n- Two funnels — supply and demand\\n- Supply often acquired through outbound / partnership / cold email\\n- Demand often acquired through SEO / paid / content\\n- City-by-city programmatic SEO common\\n\\n**Activation:**\\n- Supply activation: first listing posted, first response sent\\n- Demand activation: first purchase / first match / first transaction\\n- Both sides need their own onboarding\\n\\n**Retention:**\\n- Repeat transaction frequency\\n- Supply utilization (% of listings active)\\n- Demand habit (DAU / MAU)\\n\\n**Referral:**\\n- Supply → supply (refer other providers)\\n- Demand → demand (refer other buyers)\\n- Cross-side referrals are weaker\\n\\n**Revenue:**\\n- Take-rate optimization\\n- Premium tier (better matching, lower fees)\\n- Lead-gen vs. transaction-fee monetization\\n\\n### Skills emphasis\\n- `programmatic-seo` for city pages, vertical pages\\n- `cold-email` for supply-side recruitment\\n- `referrals` for both sides\\n- `pricing` for take-rate decisions\\n\\n### Tier-1 budget priority\\n- Programmatic SEO build for one side\\n- Cold outbound to seed supply (or demand, whichever is bottleneck)\\n- Lifecycle email for both sides\\n\\n---\\n\\n## Archetype 5 — Developer Tool / Open Source\\n\\n### Core characteristics\\n- Technical buyer (developer or eng leader)\\n- High bar for content quality (developers are skeptical)\\n- DevRel matters more than traditional marketing\\n- Open source layer often funnel into commercial product\\n\\n### AARRR emphasis\\n\\n**Acquisition:**\\n- Technical content + docs SEO\\n- DevRel (conferences, talks, community)\\n- GitHub presence + npm/pip/etc. discovery\\n- Hacker News + Reddit + dev Twitter\\n\\n**Activation:**\\n- First build / first integration is the activation event\\n- Time-to-Hello-World matters\\n- Documentation = onboarding for dev tools\\n\\n**Retention:**\\n- Depth of integration (using more of the product)\\n- Team adoption (one user → entire org)\\n- Active project count\\n\\n**Referral:**\\n- Star count on GitHub (semi-organic)\\n- Recommendation in technical forums\\n- Conference talks mentioning the tool\\n\\n**Revenue:**\\n- Free → paid conversion when usage exceeds limits\\n- Team plans, enterprise tiers\\n- Support / SLA upsells\\n\\n### Skills emphasis\\n- `programmatic-seo` for docs\\n- Less emphasis on traditional `ads`\\n- Heavy `content-strategy` + technical content\\n- `cold-email` to engineering leads at target companies\\n\\n### Tier-1 budget priority\\n- Docs + technical content production\\n- DevRel (founder doing talks)\\n- GitHub presence\\n- HN / Reddit / dev community\\n\\n---\\n\\n## Archetype 6 — Deep-Tech / Scientific / Clinical\\n\\n### Core characteristics\\n- Long sales cycles\\n- Heavy credibility burden (must prove the science)\\n- Highly informed buyers (academics, clinicians, researchers)\\n- Often regulatory considerations\\n\\n### AARRR emphasis\\n\\n**Acquisition:**\\n- Academic publishing + peer-reviewed studies\\n- Conference speaking (academic + industry)\\n- Investor / advisor introductions\\n- PR via credibility hooks\\n\\n**Activation:**\\n- Pilot programs / proof-of-concepts\\n- Concierge setup with high-touch onboarding\\n- Educational webinars / training\\n\\n**Retention:**\\n- Customer success heavily\\n- Co-publication with customers\\n- Community of practice\\n\\n**Referral:**\\n- Academic / clinical references\\n- Conference panel features\\n- Case studies with named institutions\\n\\n**Revenue:**\\n- Pilot → paid expansion\\n- Institutional contracts (multi-seat / multi-year)\\n- Compliance / certification upsells\\n\\n### Skills emphasis\\n- Light traditional marketing\\n- Heavy `product-marketing`, `sales-enablement`, `pricing`\\n- `cold-email` to specific researchers / practitioners\\n- PR + investor marketing\\n\\n### Tier-1 budget priority\\n- Academic outreach + conference speaking\\n- Investor backchannel for institutional warm intros\\n- Pilot deployment with key customers\\n- Case study + scientific publication\\n\\n---\\n\\n## Archetype 7 — Commerce / DTC (non-subscription)\\n\\n### Core characteristics\\n- Physical or digital products sold transactionally\\n- Average Order Value matters\\n- Repeat purchase rate is the key retention metric\\n\\n### AARRR emphasis\\n\\n**Acquisition:**\\n- Paid social (Meta, TikTok) often dominant\\n- Shopify SEO for product pages\\n- Amazon listings\\n- Influencer + creator partnerships\\n\\n**Activation:**\\n- First purchase is the activation event\\n- Cart abandonment recovery\\n- Trust signals on checkout (reviews, returns, shipping)\\n\\n**Retention:**\\n- Post-purchase lifecycle\\n- Loyalty programs\\n- Email + SMS for repeat purchase\\n\\n**Referral:**\\n- Gifting flows\\n- Refer-a-friend programs\\n- Reviews + UGC\\n\\n**Revenue:**\\n- AOV optimization (bundles, upsells)\\n- Customer LTV optimization (repeat purchase frequency)\\n- Subscription option for repeat purchases\\n\\n### Skills emphasis\\n- `ads` + `ad-creative` (heavy weight)\\n- `emails` for post-purchase + abandoned cart\\n- `referrals` with gifting\\n- `pricing` for bundles + subscription option\\n\\n### Tier-1 budget priority\\n- Shopify storefront optimization\\n- Email lifecycle ship\\n- Influencer / UGC seeding\\n- Paid social testing (if minimal budget exists)\\n\\n---\\n\\n## How to use this doc when drafting a plan\\n\\nWhen you start drafting Sections 4–8 (AARRR), identify the client's archetype (or hybrid if applicable) and lean into the patterns above.\\n\\n**Hybrid cases are common.** Quietude is \\\"Hybrid hardware + software\\\" with significant overlap to \\\"Deep-tech / scientific / clinical\\\" (because of the peer-reviewed study + clinical positioning). The plan blends emphases from both archetypes.\\n\\nWhen in doubt, lead with the archetype that best fits the *primary monetization model*. Quietude's primary monetization is software subscription (with hardware as the wedge), so the D2C consumer app + hardware-hybrid patterns dominate, with deep-tech credibility moves layered in.\\n\\n## When the client doesn't fit cleanly\\n\\nSome clients defy archetype:\\n- **Content / media businesses** — neither SaaS nor commerce; ad revenue or subscription model\\n- **Social networks** — own category, network effects dominate\\n- **Real estate / events** — physical + service model\\n\\nFor these, identify the closest archetype and adjust. Don't force-fit — name the deviation in the plan's Strategic Frame.\\n\"},\n {\"skill\":\"marketing-plan\",\"ref\":\"current-state-rubric\",\"body\":\"# Current State Rubric — 17-Section Scoring Lens\\n\\nThis 17-section rubric is the source of truth for Section 3 (\\\"Current State\\\") of every marketing plan. Score each section 0–5 from available materials, then write a 2–4 sentence \\\"shape interpretation\\\" that names where strengths and gaps cluster.\\n\\n## How to score\\n\\n**From rich materials.** When the team has shared decks, prior content audits, a brand voice doc, kickoff transcript, app store and analytics snapshots — score each section from those artifacts. Mark \\\"scored from materials\\\" in the section heading so the team can push back where they have better data.\\n\\n**From a separately scored audit.** If the team has already run a scored current-state assessment (in any format), ingest those scores directly. Don't redo the work — note the date the rubric was scored and flag any sections where material has shifted since.\\n\\nEither way, the output is the same: a 17-row scored table, a total out of 85, and a shape paragraph.\\n\\n## The 17 sections (scored 0–5 each)\\n\\n### 1. Positioning\\n**What's scored:** Clarity of category claim, differentiation, alignment across surfaces (homepage, app store, pitch deck, founder messaging).\\n\\n**Score guide:**\\n- 0 = No positioning anywhere\\n- 2 = Inconsistent across surfaces; team can't articulate it on demand\\n- 4 = Clear, original, mostly consistent; minor surface gaps\\n- 5 = Distinctive, category-defining, every surface aligned\\n\\n**Maps to AARRR:** Cross-cutting — feeds every stage.\\n\\n### 2. Customer research\\n**What's scored:** Depth and recency of customer research, ICP clarity, voice-of-customer capture.\\n\\n**Score guide:**\\n- 0 = No formal research, only founder intuition\\n- 2 = Some research but stale or one-off\\n- 4 = Active research practice, customer language captured\\n- 5 = Continuous research, customer language flows into copy / product / messaging\\n\\n**Maps to AARRR:** Cross-cutting — feeds especially Acquisition (channel choice) and Activation (onboarding voice).\\n\\n### 3. Homepage\\n**What's scored:** Headline clarity, voice alignment, conversion architecture, mobile experience.\\n\\n**Score guide:**\\n- 0 = Generic / broken / off-brand\\n- 2 = Functional but underperforming; voice mostly absent\\n- 4 = Clear, voice-aligned, converting; minor optimization opportunities\\n- 5 = Distinctive, converts strongly, fully voice-aligned\\n\\n**Maps to AARRR:** Acquisition + Activation.\\n\\n### 4. Sales / product pages\\n**What's scored:** Existence and quality of dedicated product / pricing / feature pages. Are SKUs documented? Is pricing scannable? Are upsells visible?\\n\\n**Score guide:**\\n- 0 = No dedicated pages\\n- 2 = Pages exist but are stale or off-voice\\n- 4 = Quality pages for primary products; gaps on secondary\\n- 5 = Every product, tier, and upsell has a high-converting page\\n\\n**Maps to AARRR:** Acquisition + Revenue.\\n\\n### 5. Conversion pages\\n**What's scored:** Landing pages for specific campaigns, channels, or use cases. `/partner`, `/science`, `/ambassadors`, `/eye-mask` types of pages.\\n\\n**Score guide:**\\n- 0 = No conversion pages\\n- 2 = One or two exist; rest of needed pages missing\\n- 4 = Most needed conversion pages exist; quality is good\\n- 5 = Full conversion page library, each high-converting\\n\\n**Maps to AARRR:** Acquisition + Activation.\\n\\n### 6. Competitor comparison\\n**What's scored:** Existence of \\\"vs. {competitor}\\\" pages, comparison content. Does the brand acknowledge alternatives, or pretend they don't exist?\\n\\n**Score guide:**\\n- 0 = Nothing — actively avoiding competitor mentions\\n- 2 = Some content exists but is weak or hidden\\n- 4 = Solid comparison pages for top 2–3 competitors\\n- 5 = Comprehensive comparison library; SEO-targeted; high-converting\\n\\n**Maps to AARRR:** Acquisition (consideration-stage SEO + sales enablement).\\n\\n### 7. Resources / content\\n**What's scored:** Blog, knowledge base, science page, whitepapers, research, founder essays, podcast.\\n\\n**Score guide:**\\n- 0 = No content surface\\n- 2 = Blog exists but is stale or thin\\n- 4 = Active content production; multiple formats\\n- 5 = Content is a moat — proprietary research, named pillars, daily volume\\n\\n**Maps to AARRR:** Acquisition.\\n\\n### 8. Onboarding\\n**What's scored:** New user onboarding (in-app + email). Time-to-value, completion rate, brand-voice alignment.\\n\\n**Score guide:**\\n- 0 = No onboarding flow\\n- 2 = Onboarding exists but is broken, off-voice, or underperforming\\n- 4 = Solid onboarding; clear bottlenecks identified\\n- 5 = Tested, optimized, on-brand; activation rate at category top quartile\\n\\n**Maps to AARRR:** Activation.\\n\\n### 9. Email lifecycle\\n**What's scored:** Existence and quality of lifecycle email programs. Welcome / onboarding / post-purchase / lapsed / win-back.\\n\\n**Score guide:**\\n- 0 = No lifecycle email\\n- 2 = Some flows exist but drafted not live, or live but stale\\n- 4 = Core flows live and performing; gaps on secondary flows\\n- 5 = Full lifecycle live, segmented, performing above category benchmarks\\n\\n**Maps to AARRR:** Retention (+ Activation for onboarding emails).\\n\\n### 10. Sales material\\n**What's scored:** Sales decks, one-pagers, demos, case studies, pricing sheets. (For B2B / hybrid companies — for pure D2C, this can be marked N/A or scored low without implication.)\\n\\n**Score guide:**\\n- 0 = No sales material\\n- 2 = Founder uses a deck but other material is thin\\n- 4 = Solid sales kit; reps can self-serve content\\n- 5 = Comprehensive material; updated quarterly; objection-handling library exists\\n\\n**Maps to AARRR:** Acquisition + Revenue (B2B).\\n\\n### 11. Messaging\\n**What's scored:** Voice, tone, vocabulary, message hierarchy across surfaces. Is the brand voice documented, consistent, distinctive?\\n\\n**Score guide:**\\n- 0 = No voice documented; surfaces inconsistent\\n- 2 = Voice exists in founder's head but isn't operationalized\\n- 4 = Documented voice; mostly consistent across surfaces\\n- 5 = Distinctive voice; documented; every surface respects it; voice is a moat\\n\\n**Maps to AARRR:** Cross-cutting.\\n\\n### 12. Pricing\\n**What's scored:** Pricing structure clarity, packaging logic, recent pressure-testing, listed vs. effective price reconciliation.\\n\\n**Score guide:**\\n- 0 = Pricing not pressure-tested in over a year; unclear structure\\n- 2 = Listed pricing exists but plan mix / discounting muddles the read\\n- 4 = Clear pricing; recent tests; LTV math known\\n- 5 = Pricing tested quarterly; packaging optimized; expansion levers known\\n\\n**Maps to AARRR:** Revenue.\\n\\n### 13. CRO (conversion rate optimization)\\n**What's scored:** Test cadence, instrumentation, A/B history, statistical rigor.\\n\\n**Score guide:**\\n- 0 = No tests run; no instrumentation\\n- 2 = Some ad-hoc tests; no statistical rigor\\n- 4 = Regular test cadence; some wins\\n- 5 = Continuous testing program; experimentation culture; documented wins\\n\\n**Maps to AARRR:** Cross-cutting (most impactful at Activation + Revenue).\\n\\n### 14. GTM launches\\n**What's scored:** Quality of past launch executions. Product launches, feature launches, campaign launches.\\n\\n**Score guide:**\\n- 0 = No structured launches; \\\"soft launches\\\" only\\n- 2 = Some launches but uneven execution\\n- 4 = Solid recent launches; playbook exists\\n- 5 = Repeatable launch motion; Product Hunt #1s; press coverage on demand\\n\\n**Maps to AARRR:** Acquisition + Activation.\\n\\n### 15. Ads (paid)\\n**What's scored:** Paid acquisition state. Active campaigns, channels, CAC tracking, creative quality.\\n\\n**Score guide:**\\n- 0 = No paid acquisition\\n- 2 = Some paid but unstructured / wasteful\\n- 4 = Paid is firing across 2–3 channels with positive unit economics\\n- 5 = Sophisticated paid stack; CAC/LTV understood; creative iterated weekly\\n\\n**Maps to AARRR:** Acquisition.\\n\\n**Note:** For pre-seed clients with no paid budget, score this 0 *without* treating it as a weakness — it reflects the funding stage, not a marketing failure.\\n\\n### 16. SEO\\n**What's scored:** Organic search performance. Domain rating, ranking keywords, organic traffic, content cluster strategy.\\n\\n**Score guide:**\\n- 0 = No SEO; new domain or zero-authority\\n- 2 = Some content but no strategy; ranks for brand only\\n- 4 = Established content clusters; growing organic traffic; DR 25+\\n- 5 = SEO is a moat; DR 40+; thousand+ ranking keywords; consistent content production\\n\\n**Maps to AARRR:** Acquisition.\\n\\n### 17. Internationalization\\n**What's scored:** Geographic expansion, language localization, region-specific pricing.\\n\\n**Score guide:**\\n- 0 = US/EN only; no international consideration\\n- 2 = International users exist but aren't served (one language, one currency)\\n- 4 = Multi-language, region-specific pricing, GTM playbook for new markets\\n- 5 = International is a strength; multi-region revenue; localized GTM\\n\\n**Maps to AARRR:** Acquisition.\\n\\n**Note:** For most early-stage companies, internationalization scores 0–1 and that's appropriate. Don't penalize early-stage companies for not having international playbooks yet.\\n\\n## How to compute the total + read the shape\\n\\n**Total = sum of all 17 scores. Out of 85.**\\n\\nThe total matters less than the *shape*. After the scoring table, write a 2–4 sentence \\\"shape interpretation\\\":\\n\\n> *\\\"High in {strong sections}, low in {weak sections}. That shape is the gap the rest of the plan closes — Sections X (AARRR stage) is the longest because that's where the gap is widest.\\\"*\\n\\n## Common shapes\\n\\n### \\\"Strong voice / messaging, weak distribution\\\"\\n- High: Positioning (#1), Customer research (#2), Messaging (#11)\\n- Low: SEO (#16), Ads (#15), GTM launches (#14)\\n- Translation: The founder is a strong storyteller but distribution hasn't caught up. Plan emphasizes Acquisition + paid layer prep.\\n\\n### \\\"Strong acquisition, weak conversion\\\"\\n- High: SEO (#16), Resources (#7), Ads (#15)\\n- Low: Homepage (#3), Onboarding (#8), Conversion pages (#5), Pricing (#12)\\n- Translation: Traffic comes in but doesn't convert. Plan emphasizes Activation + Revenue.\\n\\n### \\\"Strong conversion, weak retention\\\"\\n- High: Onboarding (#8), Homepage (#3), Pricing (#12)\\n- Low: Email lifecycle (#9), CRO (#13)\\n- Translation: Users sign up and pay but churn. Plan emphasizes Retention.\\n\\n### \\\"Strong product, weak everything-else\\\"\\n- High: only Positioning (#1) and Customer research (#2) — the founder knows the customer\\n- Low: everything operational\\n- Translation: Pre-marketing stage. Plan is foundation-heavy. First quarter is bedrock fixes.\\n\\n### \\\"Strong recent revenue, weak compounding\\\"\\n- High: Ads (#15), Sales material (#10), Pricing (#12)\\n- Low: SEO (#16), Resources (#7), Referral mechanics\\n- Translation: Performance marketing carries the business. Plan emphasizes building compounding channels before paid scales further.\\n\\n## When scores are subjective\\n\\nSome sections are easier to score from outside than others. Subjectivity tier:\\n\\n- **Objective (data-driven):** SEO (#16), Ads (#15), Email lifecycle (#9), Onboarding (#8) — backed by analytics\\n- **Semi-objective:** Pricing (#12), CRO (#13), Conversion pages (#5), Sales material (#10) — visible artifacts to evaluate\\n- **Subjective (judgment call):** Positioning (#1), Messaging (#11), Customer research (#2), Resources (#7) — interpretive\\n\\nFor subjective sections, write the rationale into the \\\"Note\\\" column so the team can push back if they disagree.\\n\\n## When a prior scored audit exists\\n\\nIf the team already has scored output from any current-state assessment, ingest those scores directly — don't redo the work. Treat that prior scoring as the ground truth for sections it covers.\\n\\nIf the prior scoring was done weeks ago and material has shifted since (new shipped flows, new content live, repositioning, etc.), note \\\"scored on YYYY-MM-DD; material has shifted since\\\" and update any specific scores you have current evidence for.\\n\"}\n];\n",[],[463,774,776],"fd801cb6-5d6d-11f1-9d15-1607ee4eb77e","ref_7.ts","fd801d7e-5d6d-11f1-9d15-1607ee4eb77e",666,["D",1780286241095],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_7: SkillRef[] = [\n {\"skill\":\"emails\",\"ref\":\"email-types\",\"body\":\"# Email Types Reference\\n\\nA comprehensive guide to lifecycle and campaign emails. Use this as an audit checklist and implementation reference.\\n\\n## Contents\\n- Onboarding Emails (new users series, new customers series, key onboarding step reminder, new user invite)\\n- Retention Emails (upgrade to paid, upgrade to higher plan, ask for review, offer support proactively, product usage report, NPS survey, referral program)\\n- Billing Emails (switch to annual, failed payment recovery, cancellation survey, upcoming renewal reminder)\\n- Usage Emails (daily/weekly/monthly summary, key event or milestone notifications)\\n- Win-Back Emails (expired trials, cancelled customers)\\n- Campaign Emails (monthly roundup/newsletter, seasonal promotions, product updates, industry news roundup, pricing update)\\n- Email Audit Checklist (onboarding, retention, billing, usage, win-back, campaigns)\\n\\n## Onboarding Emails\\n\\n### New Users Series\\n**Trigger**: User signs up (free or trial)\\n**Goal**: Activate user, drive to aha moment\\n**Typical sequence**: 5-7 emails over 14 days\\n\\n- Email 1: Welcome + single next step (immediate)\\n- Email 2: Quick win / getting started (day 1)\\n- Email 3: Key feature highlight (day 3)\\n- Email 4: Success story / social proof (day 5)\\n- Email 5: Check-in + offer help (day 7)\\n- Email 6: Advanced tip (day 10)\\n- Email 7: Upgrade prompt or next milestone (day 14)\\n\\n**Key metrics**: Activation rate, feature adoption\\n\\n---\\n\\n### New Customers Series\\n**Trigger**: User converts to paid\\n**Goal**: Reinforce purchase decision, drive adoption, reduce early churn\\n**Typical sequence**: 3-5 emails over 14 days\\n\\n- Email 1: Thank you + what's next (immediate)\\n- Email 2: Getting full value — setup checklist (day 2)\\n- Email 3: Pro tips for paid features (day 5)\\n- Email 4: Success story from similar customer (day 7)\\n- Email 5: Check-in + introduce support resources (day 14)\\n\\n**Key point**: Different from new user series—they've committed. Focus on reinforcement and expansion, not conversion.\\n\\n---\\n\\n### Key Onboarding Step Reminder\\n**Trigger**: User hasn't completed critical setup step after X time\\n**Goal**: Nudge completion of high-value action\\n**Format**: Single email or 2-3 email mini-sequence\\n\\n**Example triggers**:\\n- Hasn't connected integration after 48 hours\\n- Hasn't invited team member after 3 days\\n- Hasn't completed profile after 24 hours\\n\\n**Copy approach**:\\n- Remind them what they started\\n- Explain why this step matters\\n- Make it easy (direct link to complete)\\n- Offer help if stuck\\n\\n---\\n\\n### New User Invite\\n**Trigger**: Existing user invites teammate\\n**Goal**: Activate the invited user\\n**Recipient**: The person being invited\\n\\n- Email 1: You've been invited (immediate)\\n- Email 2: Reminder if not accepted (day 2)\\n- Email 3: Final reminder (day 5)\\n\\n**Copy approach**:\\n- Personalize with inviter's name\\n- Explain what they're joining\\n- Single CTA to accept invite\\n- Social proof optional\\n\\n---\\n\\n## Retention Emails\\n\\n### Upgrade to Paid\\n**Trigger**: Free user shows engagement, or trial ending\\n**Goal**: Convert free to paid\\n**Typical sequence**: 3-5 emails\\n\\n**Trigger options**:\\n- Time-based (trial day 10, 12, 14)\\n- Behavior-based (hit usage limit, used premium feature)\\n- Engagement-based (highly active free user)\\n\\n**Sequence structure**:\\n- Value summary: What they've accomplished\\n- Feature comparison: What they're missing\\n- Social proof: Who else upgraded\\n- Urgency: Trial ending, limited offer\\n- Final: Last chance + easy path\\n\\n---\\n\\n### Upgrade to Higher Plan\\n**Trigger**: User approaching plan limits or using features available on higher tier\\n**Goal**: Upsell to next tier\\n**Format**: Single email or 2-3 email sequence\\n\\n**Trigger examples**:\\n- 80% of seat limit reached\\n- 90% of storage/usage limit\\n- Tried to use higher-tier feature\\n- Power user behavior patterns\\n\\n**Copy approach**:\\n- Acknowledge their growth (positive framing)\\n- Show what next tier unlocks\\n- Quantify value vs. cost\\n- Easy upgrade path\\n\\n---\\n\\n### Ask for Review\\n**Trigger**: Customer milestone (30/60/90 days, key achievement, support resolution)\\n**Goal**: Generate social proof on G2, Capterra, app stores\\n**Format**: Single email\\n\\n**Best timing**:\\n- After positive support interaction\\n- After achieving measurable result\\n- After renewal\\n- NOT after billing issues or bugs\\n\\n**Copy approach**:\\n- Thank them for being a customer\\n- Mention specific value/milestone if possible\\n- Explain why reviews matter (help others decide)\\n- Direct link to review platform\\n- Keep it short—this is an ask\\n\\n---\\n\\n### Offer Support Proactively\\n**Trigger**: Signs of struggle (drop in usage, failed actions, error encounters)\\n**Goal**: Save at-risk user, improve experience\\n**Format**: Single email\\n\\n**Trigger examples**:\\n- Usage dropped significantly week-over-week\\n- Multiple failed attempts at action\\n- Viewed help docs repeatedly\\n- Stuck at same onboarding step\\n\\n**Copy approach**:\\n- Genuine concern tone\\n- Specific: \\\"I noticed you...\\\" (if data allows)\\n- Offer direct help (not just link to docs)\\n- Personal from support or CSM\\n- No sales pitch—pure help\\n\\n---\\n\\n### Product Usage Report\\n**Trigger**: Time-based (weekly, monthly, quarterly)\\n**Goal**: Demonstrate value, drive engagement, reduce churn\\n**Format**: Single email, recurring\\n\\n**What to include**:\\n- Key metrics/activity summary\\n- Comparison to previous period\\n- Achievements/milestones\\n- Suggestions for improvement\\n- Light CTA to explore more\\n\\n**Examples**:\\n- \\\"You saved X hours this month\\\"\\n- \\\"Your team completed X projects\\\"\\n- \\\"You're in the top X% of users\\\"\\n\\n**Key point**: Make them feel good and remind them of value delivered.\\n\\n---\\n\\n### NPS Survey\\n**Trigger**: Time-based (quarterly) or event-based (post-milestone)\\n**Goal**: Measure satisfaction, identify promoters and detractors\\n**Format**: Single email\\n\\n**Best practices**:\\n- Keep it simple: Just the NPS question initially\\n- Follow-up form for \\\"why\\\" based on score\\n- Personal sender (CEO, founder, CSM)\\n- Tell them how you'll use feedback\\n\\n**Follow-up based on score**:\\n- Promoters (9-10): Thank + ask for review/referral\\n- Passives (7-8): Ask what would make it a 10\\n- Detractors (0-6): Personal outreach to understand issues\\n\\n---\\n\\n### Referral Program\\n**Trigger**: Customer milestone, promoter NPS score, or campaign\\n**Goal**: Generate referrals\\n**Format**: Single email or periodic reminders\\n\\n**Good timing**:\\n- After positive NPS response\\n- After customer achieves result\\n- After renewal\\n- Seasonal campaigns\\n\\n**Copy approach**:\\n- Remind them of their success\\n- Explain the referral offer clearly\\n- Make sharing easy (unique link)\\n- Show what's in it for them AND referee\\n\\n---\\n\\n## Billing Emails\\n\\n### Switch to Annual\\n**Trigger**: Monthly subscriber at renewal time or campaign\\n**Goal**: Convert monthly to annual (improve LTV, reduce churn)\\n**Format**: Single email or 2-email sequence\\n\\n**Value proposition**:\\n- Calculate exact savings\\n- Additional benefits (if any)\\n- Lock in current price messaging\\n- Easy one-click switch\\n\\n**Best timing**:\\n- Around monthly renewal date\\n- End of year / new year\\n- After 3-6 months of loyalty\\n- Price increase announcement (lock in old rate)\\n\\n---\\n\\n### Failed Payment Recovery\\n**Trigger**: Payment fails\\n**Goal**: Recover revenue, retain customer\\n**Typical sequence**: 3-4 emails over 7-14 days\\n\\n**Sequence structure**:\\n- Email 1 (Day 0): Friendly notice, update payment link\\n- Email 2 (Day 3): Reminder, service may be interrupted\\n- Email 3 (Day 7): Urgent, account will be suspended\\n- Email 4 (Day 10-14): Final notice, what they'll lose\\n\\n**Copy approach**:\\n- Assume it's an accident (card expired, etc.)\\n- Clear, direct, no guilt\\n- Single CTA to update payment\\n- Explain what happens if not resolved\\n\\n**Key metrics**: Recovery rate, time to recovery\\n\\n---\\n\\n### Cancellation Survey\\n**Trigger**: User cancels subscription\\n**Goal**: Learn why, opportunity to save\\n**Format**: Single email (immediate)\\n\\n**Options**:\\n- In-app survey at cancellation (better completion)\\n- Follow-up email if they skip in-app\\n- Personal outreach for high-value accounts\\n\\n**Questions to ask**:\\n- Primary reason for cancelling\\n- What could we have done better\\n- Would anything change your mind\\n- Can we help with transition\\n\\n**Winback opportunity**: Based on reason, offer targeted save (discount, pause, downgrade, training).\\n\\n---\\n\\n### Upcoming Renewal Reminder\\n**Trigger**: X days before renewal (14 or 30 days typical)\\n**Goal**: No surprise charges, opportunity to expand\\n**Format**: Single email\\n\\n**What to include**:\\n- Renewal date and amount\\n- What's included in renewal\\n- How to update payment/plan\\n- Changes to pricing/features (if any)\\n- Optional: Upsell opportunity\\n\\n**Required for**: Annual subscriptions, high-value contracts\\n\\n---\\n\\n## Usage Emails\\n\\n### Daily/Weekly/Monthly Summary\\n**Trigger**: Time-based\\n**Goal**: Drive engagement, demonstrate value\\n**Format**: Single email, recurring\\n\\n**Content by frequency**:\\n- **Daily**: Notifications, quick stats (for high-engagement products)\\n- **Weekly**: Activity summary, highlights, suggestions\\n- **Monthly**: Comprehensive report, achievements, ROI if calculable\\n\\n**Structure**:\\n- Key metrics at a glance\\n- Notable achievements\\n- Activity breakdown\\n- Suggestions / what to try next\\n- CTA to dive deeper\\n\\n**Personalization**: Must be relevant to their actual usage. Empty reports are worse than no report.\\n\\n---\\n\\n### Key Event or Milestone Notifications\\n**Trigger**: Specific achievement or event\\n**Goal**: Celebrate, drive continued engagement\\n**Format**: Single email per event\\n\\n**Milestone examples**:\\n- First [action] completed\\n- 10th/100th [thing] created\\n- Goal achieved\\n- Team collaboration milestone\\n- Usage streak\\n\\n**Copy approach**:\\n- Celebration tone\\n- Specific achievement\\n- Context (compared to others, compared to before)\\n- What's next / next milestone\\n\\n---\\n\\n## Win-Back Emails\\n\\n### Expired Trials\\n**Trigger**: Trial ended without conversion\\n**Goal**: Convert or re-engage\\n**Typical sequence**: 3-4 emails over 30 days\\n\\n**Sequence structure**:\\n- Email 1 (Day 1 post-expiry): Trial ended, here's what you're missing\\n- Email 2 (Day 7): What held you back? (gather feedback)\\n- Email 3 (Day 14): Incentive offer (discount, extended trial)\\n- Email 4 (Day 30): Final reach-out, door is open\\n\\n**Segmentation**: Different approach based on trial engagement level:\\n- High engagement: Focus on removing friction to convert\\n- Low engagement: Offer fresh start, more onboarding help\\n- No engagement: Ask what happened, offer demo/call\\n\\n---\\n\\n### Cancelled Customers\\n**Trigger**: Time after cancellation (30, 60, 90 days)\\n**Goal**: Win back churned customers\\n**Typical sequence**: 2-3 emails spread over 90 days\\n\\n**Sequence structure**:\\n- Email 1 (Day 30): What's new since you left\\n- Email 2 (Day 60): We've addressed [common reason]\\n- Email 3 (Day 90): Special offer to return\\n\\n**Copy approach**:\\n- No guilt, no desperation\\n- Genuine updates and improvements\\n- Personalize based on cancellation reason if known\\n- Make return easy\\n\\n**Key point**: They're more likely to return if their reason was addressed.\\n\\n---\\n\\n## Campaign Emails\\n\\n### Monthly Roundup / Newsletter\\n**Trigger**: Time-based (monthly)\\n**Goal**: Engagement, brand presence, content distribution\\n**Format**: Single email, recurring\\n\\n**Content mix**:\\n- Product updates and tips\\n- Customer stories\\n- Educational content\\n- Company news\\n- Industry insights\\n\\n**Best practices**:\\n- Consistent send day/time\\n- Scannable format\\n- Mix of content types\\n- One primary CTA focus\\n- Unsubscribe is okay—keeps list healthy\\n\\n---\\n\\n### Seasonal Promotions\\n**Trigger**: Calendar events (Black Friday, New Year, etc.)\\n**Goal**: Drive conversions with timely offer\\n**Format**: Campaign burst (2-4 emails)\\n\\n**Common opportunities**:\\n- New Year (fresh start, annual planning)\\n- End of fiscal year (budget spending)\\n- Black Friday / Cyber Monday\\n- Industry-specific seasons\\n- Back to school / work\\n\\n**Sequence structure**:\\n- Announcement: Offer reveal\\n- Reminder: Midway through promotion\\n- Last chance: Final hours\\n\\n---\\n\\n### Product Updates\\n**Trigger**: New feature release\\n**Goal**: Adoption, engagement, demonstrate momentum\\n**Format**: Single email per major release\\n\\n**What to include**:\\n- What's new (clear and simple)\\n- Why it matters (benefit, not just feature)\\n- How to use it (direct link)\\n- Who asked for it (community acknowledgment)\\n\\n**Segmentation**: Consider targeting based on relevance:\\n- Users who would benefit most\\n- Users who requested feature\\n- Power users first (for beta feel)\\n\\n---\\n\\n### Industry News Roundup\\n**Trigger**: Time-based (weekly or monthly)\\n**Goal**: Thought leadership, engagement, brand value\\n**Format**: Curated newsletter\\n\\n**Content**:\\n- Curated news and links\\n- Your take / commentary\\n- What it means for readers\\n- How your product helps\\n\\n**Best for**: B2B products where customers care about industry trends.\\n\\n---\\n\\n### Pricing Update\\n**Trigger**: Price change announcement\\n**Goal**: Transparent communication, minimize churn\\n**Format**: Single email (or sequence for major changes)\\n\\n**Timeline**:\\n- Announce 30-60 days before change\\n- Reminder 14 days before\\n- Final notice 7 days before\\n\\n**Copy approach**:\\n- Clear, direct, transparent\\n- Explain the why (value delivered, costs increased)\\n- Grandfather if possible (lock in old rate)\\n- Give options (annual lock-in, downgrade)\\n\\n**Important**: Honesty and advance notice build trust even when price increases.\\n\\n---\\n\\n## Email Audit Checklist\\n\\nUse this to audit your current email program:\\n\\n### Onboarding\\n- [ ] New users series\\n- [ ] New customers series\\n- [ ] Key onboarding step reminders\\n- [ ] New user invite sequence\\n\\n### Retention\\n- [ ] Upgrade to paid sequence\\n- [ ] Upgrade to higher plan triggers\\n- [ ] Ask for review (timed properly)\\n- [ ] Proactive support outreach\\n- [ ] Product usage reports\\n- [ ] NPS survey\\n- [ ] Referral program emails\\n\\n### Billing\\n- [ ] Switch to annual campaign\\n- [ ] Failed payment recovery sequence\\n- [ ] Cancellation survey\\n- [ ] Upcoming renewal reminders\\n\\n### Usage\\n- [ ] Daily/weekly/monthly summaries\\n- [ ] Key event notifications\\n- [ ] Milestone celebrations\\n\\n### Win-Back\\n- [ ] Expired trial sequence\\n- [ ] Cancelled customer sequence\\n\\n### Campaigns\\n- [ ] Monthly roundup / newsletter\\n- [ ] Seasonal promotion calendar\\n- [ ] Product update announcements\\n- [ ] Pricing update communications\\n\"},\n {\"skill\":\"emails\",\"ref\":\"sequence-templates\",\"body\":\"# Email Sequence Templates\\n\\nDetailed templates for common email sequences.\\n\\n## Contents\\n- Welcome Sequence (Post-Signup)\\n- Lead Nurture Sequence (Pre-Sale)\\n- Re-Engagement Sequence\\n- Onboarding Sequence (Product Users)\\n\\n## Welcome Sequence (Post-Signup)\\n\\n**Email 1: Welcome (Immediate)**\\n- Subject: Welcome to [Product] — here's your first step\\n- Deliver what was promised (lead magnet, access, etc.)\\n- Single next action\\n- Set expectations for future emails\\n\\n**Email 2: Quick Win (Day 1-2)**\\n- Subject: Get your first [result] in 10 minutes\\n- Enable small success\\n- Build confidence\\n- Link to helpful resource\\n\\n**Email 3: Story/Why (Day 3-4)**\\n- Subject: Why we built [Product]\\n- Origin story or mission\\n- Connect emotionally\\n- Show you understand their problem\\n\\n**Email 4: Social Proof (Day 5-6)**\\n- Subject: How [Customer] achieved [Result]\\n- Case study or testimonial\\n- Relatable to their situation\\n- Soft CTA to explore\\n\\n**Email 5: Overcome Objection (Day 7-8)**\\n- Subject: \\\"I don't have time for X\\\" — sound familiar?\\n- Address common hesitation\\n- Reframe the obstacle\\n- Show easy path forward\\n\\n**Email 6: Core Feature (Day 9-11)**\\n- Subject: Have you tried [Feature] yet?\\n- Highlight underused capability\\n- Show clear benefit\\n- Direct CTA to try it\\n\\n**Email 7: Conversion (Day 12-14)**\\n- Subject: Ready to [upgrade/buy/commit]?\\n- Summarize value\\n- Clear offer\\n- Urgency if appropriate\\n- Risk reversal (guarantee, trial)\\n\\n---\\n\\n## Lead Nurture Sequence (Pre-Sale)\\n\\n**Email 1: Deliver + Introduce (Immediate)**\\n- Deliver the lead magnet\\n- Brief intro to who you are\\n- Preview what's coming\\n\\n**Email 2: Expand on Topic (Day 2-3)**\\n- Related insight to lead magnet\\n- Establish expertise\\n- Light CTA to content\\n\\n**Email 3: Problem Deep-Dive (Day 4-5)**\\n- Articulate their problem deeply\\n- Show you understand\\n- Hint at solution\\n\\n**Email 4: Solution Framework (Day 6-8)**\\n- Your approach/methodology\\n- Educational, not salesy\\n- Builds toward your product\\n\\n**Email 5: Case Study (Day 9-11)**\\n- Real results from real customer\\n- Specific and relatable\\n- Soft CTA\\n\\n**Email 6: Differentiation (Day 12-14)**\\n- Why your approach is different\\n- Address alternatives\\n- Build preference\\n\\n**Email 7: Objection Handler (Day 15-18)**\\n- Common concern addressed\\n- FAQ or myth-busting\\n- Reduce friction\\n\\n**Email 8: Direct Offer (Day 19-21)**\\n- Clear pitch\\n- Strong value proposition\\n- Specific CTA\\n- Urgency if available\\n\\n---\\n\\n## Re-Engagement Sequence\\n\\n**Email 1: Check-In (Day 30-60 of inactivity)**\\n- Subject: Is everything okay, [Name]?\\n- Genuine concern\\n- Ask what happened\\n- Easy win to re-engage\\n\\n**Email 2: Value Reminder (Day 2-3 after)**\\n- Subject: Remember when you [achieved X]?\\n- Remind of past value\\n- What's new since they left\\n- Quick CTA\\n\\n**Email 3: Incentive (Day 5-7 after)**\\n- Subject: We miss you — here's something special\\n- Offer if appropriate\\n- Limited time\\n- Clear CTA\\n\\n**Email 4: Last Chance (Day 10-14 after)**\\n- Subject: Should we stop emailing you?\\n- Honest and direct\\n- One-click to stay or go\\n- Clean the list if no response\\n\\n---\\n\\n## Onboarding Sequence (Product Users)\\n\\nCoordinate with in-app onboarding. Email supports, doesn't duplicate.\\n\\n**Email 1: Welcome + First Step (Immediate)**\\n- Confirm signup\\n- One critical action\\n- Link directly to that action\\n\\n**Email 2: Getting Started Help (Day 1)**\\n- If they haven't completed step 1\\n- Quick tip or video\\n- Support option\\n\\n**Email 3: Feature Highlight (Day 2-3)**\\n- Key feature they should know\\n- Specific use case\\n- In-app link\\n\\n**Email 4: Success Story (Day 4-5)**\\n- Customer who succeeded\\n- Relatable journey\\n- Motivational\\n\\n**Email 5: Check-In (Day 7)**\\n- How's it going?\\n- Ask for feedback\\n- Offer help\\n\\n**Email 6: Advanced Tip (Day 10-12)**\\n- Power feature\\n- For engaged users\\n- Level-up content\\n\\n**Email 7: Upgrade/Expand (Day 14+)**\\n- For trial users: conversion push\\n- For free users: upgrade prompt\\n- For paid: expansion opportunity\\n\"},\n {\"skill\":\"free-tools\",\"ref\":\"tool-types\",\"body\":\"# Free Tool Types Reference\\n\\nDetailed guide to each type of marketing tool you can build.\\n\\n## Contents\\n- Calculators\\n- Generators\\n- Analyzers/Auditors\\n- Testers/Validators\\n- Libraries/Resources\\n- Interactive Educational\\n- Tool Concept Examples by Industry (SaaS product, agency/services, e-commerce, developer tools, finance)\\n\\n## Calculators\\n\\n**Best for**: Decisions involving numbers, comparisons, estimates\\n\\n**Examples**:\\n- ROI calculator\\n- Savings calculator\\n- Cost comparison tool\\n- Salary calculator\\n- Tax estimator\\n- Pricing estimator\\n- Compound interest calculator\\n- Break-even calculator\\n\\n**Why they work**:\\n- Personalized output\\n- High perceived value\\n- Share-worthy results\\n- Clear problem → solution\\n\\n**Implementation tips**:\\n- Keep inputs simple\\n- Show calculations transparently\\n- Make results shareable\\n- Add \\\"powered by\\\" branding\\n\\n---\\n\\n## Generators\\n\\n**Best for**: Creating something useful quickly\\n\\n**Examples**:\\n- Policy generator (privacy, terms)\\n- Template generator\\n- Name/tagline generator\\n- Email subject line generator\\n- Resume builder\\n- Color palette generator\\n- Logo maker\\n- Contract generator\\n\\n**Why they work**:\\n- Tangible output\\n- Saves time\\n- Easily shared\\n- Repeat usage\\n\\n**Implementation tips**:\\n- Output should be immediately usable\\n- Allow customization\\n- Offer download/export options\\n- Include email gating for premium outputs\\n\\n---\\n\\n## Analyzers/Auditors\\n\\n**Best for**: Evaluating existing work or assets\\n\\n**Examples**:\\n- Website grader\\n- SEO analyzer\\n- Email subject tester\\n- Headline analyzer\\n- Security checker\\n- Performance auditor\\n- Accessibility checker\\n- Code quality analyzer\\n\\n**Why they work**:\\n- Curiosity-driven\\n- Personalized insights\\n- Creates awareness of problems\\n- Natural lead to solution\\n\\n**Implementation tips**:\\n- Score or grade for gamification\\n- Benchmark against averages\\n- Provide actionable recommendations\\n- Follow up with improvement offers\\n\\n---\\n\\n## Testers/Validators\\n\\n**Best for**: Checking if something works\\n\\n**Examples**:\\n- Meta tag preview\\n- Email rendering test\\n- Mobile-friendly test\\n- Speed test\\n- DNS checker\\n- SSL certificate checker\\n- Redirect checker\\n- Broken link finder\\n\\n**Why they work**:\\n- Immediate utility\\n- Bookmark-worthy\\n- Repeat usage\\n- Professional necessity\\n\\n**Implementation tips**:\\n- Fast results are essential\\n- Show pass/fail clearly\\n- Provide fix instructions\\n- Integrate with your product where relevant\\n\\n---\\n\\n## Libraries/Resources\\n\\n**Best for**: Reference material\\n\\n**Examples**:\\n- Icon library\\n- Template library\\n- Code snippet library\\n- Example gallery\\n- Industry directory\\n- Resource list\\n- Swipe file collection\\n- Font pairing tool\\n\\n**Why they work**:\\n- High SEO value\\n- Ongoing traffic\\n- Establishes authority\\n- Linkable asset\\n\\n**Implementation tips**:\\n- Make searchable/filterable\\n- Allow easy copying/downloading\\n- Update regularly\\n- Accept community submissions\\n\\n---\\n\\n## Interactive Educational\\n\\n**Best for**: Learning/understanding\\n\\n**Examples**:\\n- Interactive tutorials\\n- Code playgrounds\\n- Visual explainers\\n- Quizzes/assessments\\n- Simulators\\n- Comparison tools\\n- Decision trees\\n- Configurators\\n\\n**Why they work**:\\n- Engages deeply\\n- Demonstrates expertise\\n- Shareable\\n- Memory-creating\\n\\n**Implementation tips**:\\n- Make it hands-on\\n- Show immediate feedback\\n- Lead to deeper resources\\n- Capture engaged users\\n\\n---\\n\\n## Tool Concept Examples by Industry\\n\\n### SaaS Product\\n- Product ROI calculator\\n- Competitor comparison tool\\n- Readiness assessment quiz\\n- Template library for use case\\n- Feature configurator\\n\\n### Agency/Services\\n- Industry benchmark tool\\n- Project scoping calculator\\n- Portfolio review tool\\n- Cost estimator\\n- Proposal generator\\n\\n### E-commerce\\n- Product finder quiz\\n- Comparison tool\\n- Size/fit calculator\\n- Savings calculator\\n- Gift finder\\n\\n### Developer Tools\\n- Code snippet library\\n- Testing/preview tool\\n- Documentation generator\\n- Interactive tutorials\\n- API playground\\n\\n### Finance\\n- Financial calculators\\n- Investment comparison\\n- Budget planner\\n- Tax estimator\\n- Loan calculator\\n\"},\n {\"skill\":\"image\",\"ref\":\"ai-image-prompting\",\"body\":\"# AI Image Prompting Guide\\n\\nHow to write effective prompts for AI image generation models (Gemini/Nano Banana, Flux, Ideogram, DALL-E, Midjourney).\\n\\n---\\n\\n## Prompt Structure\\n\\nA strong image prompt follows this formula:\\n\\n```\\n[Subject] + [Setting/context] + [Visual style] + [Lighting] + [Composition] + [Technical specs]\\n```\\n\\n### Example Prompts by Use Case\\n\\n**Blog hero — SaaS product:**\\n```\\nA clean workspace with a laptop displaying a colorful analytics dashboard,\\nminimalist desk with a coffee cup and notebook,\\nbright natural window lighting from the right,\\nshallow depth of field, commercial photography style,\\n1200x630, high resolution\\n```\\n\\n**Social media graphic — announcement:**\\n```\\nAbstract flowing gradient in deep purple and electric blue,\\ngeometric shapes forming a network pattern,\\ndramatic rim lighting on edges,\\nmodern tech aesthetic, clean and minimal,\\n1080x1080, vibrant colors\\n```\\n\\n**Product lifestyle shot:**\\n```\\nA person in a modern office smiling while looking at a tablet,\\nshowing a project management interface on screen,\\nwarm candid photography, natural lighting,\\nmedium shot, shallow depth of field, editorial style\\n```\\n\\n**Profile banner — professional:**\\n```\\nWide panoramic abstract background in navy blue and teal,\\nsubtle geometric grid pattern with soft gradient,\\nclean corporate aesthetic, muted lighting,\\n1584x396, no text, space for logo overlay on left third\\n```\\n\\n**Directory listing — Product Hunt:**\\n```\\nProduct screenshot on a clean gradient background,\\nsoft shadow underneath, slight 3D perspective tilt,\\nmodern SaaS product presentation style,\\n1270x760, bright and professional\\n```\\n\\n---\\n\\n## Style Keywords\\n\\n### Photorealistic\\n- \\\"commercial photography\\\"\\n- \\\"shot on Canon EOS R5\\\"\\n- \\\"editorial style\\\"\\n- \\\"natural lighting\\\"\\n- \\\"shallow depth of field\\\"\\n\\n### Clean/Corporate\\n- \\\"clean modern aesthetic\\\"\\n- \\\"minimal design\\\"\\n- \\\"professional corporate style\\\"\\n- \\\"bright and airy\\\"\\n- \\\"white background\\\"\\n\\n### Illustrative\\n- \\\"flat vector illustration\\\"\\n- \\\"isometric 3D render\\\"\\n- \\\"hand-drawn sketch style\\\"\\n- \\\"watercolor illustration\\\"\\n- \\\"line art\\\"\\n\\n### Abstract/Brand\\n- \\\"flowing gradient\\\"\\n- \\\"geometric pattern\\\"\\n- \\\"abstract data visualization\\\"\\n- \\\"particle effects\\\"\\n- \\\"holographic iridescent\\\"\\n\\n### Tech/SaaS\\n- \\\"dark mode UI aesthetic\\\"\\n- \\\"neon accent lighting\\\"\\n- \\\"glassmorphism\\\"\\n- \\\"futuristic minimal\\\"\\n- \\\"developer-focused\\\"\\n\\n---\\n\\n## Lighting Keywords\\n\\n| Term | Effect | Best For |\\n|------|--------|----------|\\n| **Natural light** | Warm, organic feel | Lifestyle, editorial |\\n| **Studio lighting** | Even, controlled | Product shots |\\n| **Rim lighting** | Edge highlights, dramatic | Hero images, abstract |\\n| **Soft directional** | Gentle shadows, dimensional | Blog headers |\\n| **Volumetric** | Light rays, atmospheric | Dramatic, cinematic |\\n| **Flat/even** | No shadows, clean | Icons, diagrams |\\n| **Golden hour** | Warm orange tones | Lifestyle, outdoor |\\n| **High key** | Bright, minimal shadows | Clean, corporate |\\n\\n---\\n\\n## Composition Keywords\\n\\n| Term | Effect | Best For |\\n|------|--------|----------|\\n| **Rule of thirds** | Subject off-center | Editorial, lifestyle |\\n| **Centered** | Subject in middle | Product shots, icons |\\n| **Wide/panoramic** | Expansive view | Banners, headers |\\n| **Close-up/macro** | Detail focus | Texture, product detail |\\n| **Bird's eye/overhead** | Top-down view | Desk setups, flat lays |\\n| **Negative space** | Room for text overlay | Blog headers, banners |\\n| **Symmetrical** | Balanced, formal | Corporate, luxury |\\n\\n---\\n\\n## Model-Specific Tips\\n\\n### Gemini Image (Google)\\n\\n- Best all-around for marketing images — good quality, reasonable cost\\n- Supports **image editing** — upload an existing image and describe changes\\n- Decent text rendering — can handle short headlines\\n- Specify \\\"high resolution\\\" for best output\\n- Works well with detailed, descriptive prompts\\n- Same API as text generation — easy to integrate\\n\\n### Flux (Black Forest Labs)\\n\\n- **Multi-image reference** is the killer feature — upload product screenshots, brand assets, or style references\\n- Best for **brand consistency** across a set of images\\n- Use Flux Pro for final assets, Flux Dev for rapid iteration\\n- Flux Klein for high-volume batch generation (cheapest)\\n- Style transfer via reference images > style keywords in prompt\\n- Prompts can be shorter than other models — the references do heavy lifting\\n\\n### Ideogram\\n\\n- **Best text rendering** of any model (industry-leading accuracy)\\n- Use when you need headlines, taglines, or brand names in the image\\n- Style reference system (up to 3 images) for brand consistency\\n- Supports \\\"Magic Prompt\\\" auto-enhancement\\n- Keep text requests simple — 3-5 words max for reliability\\n- Best for social graphics and banners that need text baked in\\n\\n### GPT Image (OpenAI)\\n\\n- Current models: `gpt-image-1` and variants (DALL-E 3 is deprecated)\\n- Integrated with ChatGPT — conversational image generation\\n- Good at following detailed prompts\\n- Decent text rendering (behind Ideogram, comparable to Gemini)\\n- Automatic prompt rewriting — may deviate from exact request\\n- Best for quick one-offs through ChatGPT interface\\n- API gives more control than ChatGPT interface\\n\\n### Midjourney\\n\\n- Highest aesthetic quality for artistic/editorial images\\n- No official API — Discord-based or web interface\\n- **Not agent-friendly** — use for manual creative exploration only\\n- Style flags: `--style raw` for less stylized, `--ar 16:9` for aspect ratio\\n- Best for hero images where pure visual quality matters most\\n- V6+ has improved text rendering but still unreliable\\n\\n---\\n\\n## Common Prompt Mistakes\\n\\n| Mistake | Why It Fails | Fix |\\n|---------|-------------|-----|\\n| \\\"A professional image\\\" | No visual detail | Describe subject, setting, style, lighting |\\n| Long paragraph of text in image | Models can't render paragraphs | 3-5 words max; add text in post |\\n| \\\"Make it look good\\\" | Not actionable | Specify style: \\\"commercial photography, bright\\\" |\\n| 200+ word prompts | Models lose focus | 40-80 words, specific over comprehensive |\\n| No aspect ratio | Random output size | Always specify dimensions or ratio |\\n| \\\"Logo in bottom right\\\" | Unreliable placement | Add logos in post-processing |\\n| \\\"Make it viral\\\" | Not a visual instruction | Describe the aesthetic you want |\\n| Requesting UI screenshots | AI hallucinates interfaces | Capture real screenshots instead |\\n\\n---\\n\\n## Batch Generation Workflow\\n\\nWhen you need multiple images with consistent style (e.g., a blog series or social campaign):\\n\\n1. **Generate 3-4 test images** with different style prompts\\n2. **Pick the winning style** based on brand fit\\n3. **Save the exact prompt** as your template\\n4. **Use Flux multi-reference** — upload the winning image as a style reference\\n5. **Batch generate** variations with the same style, different subjects\\n6. **Post-process** — add text overlays, logos, crop to platform sizes\\n\\n---\\n\\n## Aspect Ratios Quick Reference\\n\\n| Use Case | Ratio | Pixels | Notes |\\n|----------|-------|--------|-------|\\n| Blog hero / OG image | 1.91:1 | 1200x630 | Universal web standard |\\n| Full-width hero | 16:9 | 1920x1080 | Website headers |\\n| Instagram Feed | 1:1 | 1080x1080 | Square |\\n| Instagram Feed (tall) | 4:5 | 1080x1350 | More screen real estate |\\n| Stories / Reels | 9:16 | 1080x1920 | Vertical full screen |\\n| LinkedIn cover | 4:1 | 1584x396 | Personal profile |\\n| Twitter/X header | 3:1 | 1500x500 | Profile banner |\\n| Product Hunt gallery | 5:3 | 1270x760 | Launch page |\\n| GitHub social preview | 2:1 | 1280x640 | Repo link card |\\n\\n---\\n\\n## Cost Optimization\\n\\n- **Iterate at low quality first** — use Flux Dev or Gemini Flash for drafts, upgrade for finals\\n- **Use references over long prompts** — Flux multi-reference produces more consistent results with fewer retries\\n- **Batch similar requests** — generate all blog headers in one session with the same style\\n- **Cache and reuse** — abstract backgrounds, patterns, and textures can be reused across multiple images\\n- **Post-process instead of re-generate** — crop, overlay text, and adjust color in code rather than generating new images\\n\"},\n {\"skill\":\"lead-magnets\",\"ref\":\"benchmarks\",\"body\":\"# Lead Magnet Benchmarks\\n\\nReference data for planning and evaluating lead magnet performance.\\n\\n---\\n\\n## Conversion Rate Benchmarks\\n\\n### By Format Type\\n\\n| Format | Landing Page Conversion | Notes |\\n|--------|------------------------|-------|\\n| Checklist | 30-50% | High because low commitment |\\n| Cheat sheet | 25-40% | Quick reference appeal |\\n| Template | 25-45% | Immediate utility drives conversion |\\n| Ebook/guide | 20-35% | Higher commitment, lower rate |\\n| Quiz | 30-50% | Engagement drives completion |\\n| Webinar | 20-40% (registration) | 30-50% attendance rate of registrants |\\n| Mini-course | 15-30% | Higher commitment, higher quality leads |\\n| Free trial | 5-15% | High intent but high friction |\\n\\n### By Traffic Source\\n\\n| Source | Expected Conversion | Why |\\n|--------|-------------------|-----|\\n| Blog content upgrade | 3-8% of post readers | Contextually relevant |\\n| Dedicated landing page (organic) | 20-40% | High intent |\\n| Dedicated landing page (paid) | 10-25% | Cold traffic |\\n| Exit-intent popup | 2-5% of visitors | Interruption-based |\\n| Sidebar/banner CTA | 0.5-2% | Low engagement |\\n| Social media link | 10-20% | Warm but browsing |\\n\\n### By Industry (Landing Page)\\n\\n| Industry | Average Conversion |\\n|----------|-------------------|\\n| SaaS/Tech | 15-25% |\\n| Marketing/Agency | 20-35% |\\n| Finance | 10-20% |\\n| E-commerce | 10-20% |\\n| Education | 20-35% |\\n| Health/Wellness | 15-25% |\\n\\n---\\n\\n## Lead Quality Indicators\\n\\n### Signals of High-Quality Leads\\n- Open first 3 emails at 40%+ rate\\n- Click through to content or product pages\\n- Return to site within 30 days\\n- Match ICP demographics (role, company size, industry)\\n- Progress to trial, demo, or purchase within 90 days\\n\\n### Signals of Low-Quality Leads\\n- Unsubscribe within first 3 emails\\n- Never open beyond delivery email\\n- Use disposable email addresses\\n- Don't match target customer profile\\n- Downloaded for the content, no product interest\\n\\n### Quality vs. Quantity by Format\\n\\n| Format | Lead Volume | Lead Quality | Net Value |\\n|--------|-------------|-------------|-----------|\\n| Generic ebook | High | Low-Medium | Medium |\\n| Specific template | Medium | High | High |\\n| Industry report | Medium | Medium-High | High |\\n| Quiz/assessment | High | Medium (segmentable) | High |\\n| Webinar | Low-Medium | High | High |\\n| Checklist | High | Low-Medium | Medium |\\n| Free trial | Low | Very High | Very High |\\n\\n---\\n\\n## Cost Benchmarks\\n\\n### Cost Per Lead by Channel\\n\\n| Channel | Typical CPL | Notes |\\n|---------|-------------|-------|\\n| Organic search | $0-5 | Lowest, but slow to build |\\n| Blog content upgrade | $0-2 | Nearly free if you have traffic |\\n| Facebook/Instagram Ads | $3-15 | B2C lower, B2B higher |\\n| Google Ads | $10-50 | High intent, higher cost |\\n| LinkedIn Ads | $25-75 | B2B, expensive but qualified |\\n| Partner co-promotion | $0-5 | Depends on relationship |\\n\\n### Creation Cost by Format\\n\\n| Format | DIY Cost | With Designer/Freelancer |\\n|--------|----------|-------------------------|\\n| Checklist | Free | $100-300 |\\n| Cheat sheet | Free | $200-500 |\\n| Template | Free | $100-500 |\\n| Ebook (10-25 pages) | Free | $500-2,000 |\\n| Quiz | $0-100/mo (tool) | $500-2,000 |\\n| Webinar | Free (Zoom) | $500-1,500 (production) |\\n| Mini-course (email) | Free | $500-1,500 (copywriting) |\\n| Video course | $0-200 (gear) | $2,000-5,000 |\\n\\n---\\n\\n## Timeline Expectations\\n\\n### Time to Create\\n\\n| Format | Solo Creator | With Team |\\n|--------|-------------|-----------|\\n| Checklist | 1-2 hours | Same day |\\n| Cheat sheet | 2-4 hours | Same day |\\n| Template | 2-8 hours | 1-2 days |\\n| Swipe file | 4-8 hours | 1-2 days |\\n| Ebook | 1-3 weeks | 1-2 weeks |\\n| Quiz | 1-2 weeks | 1 week |\\n| Webinar prep | 1 week | 3-5 days |\\n| Mini-course | 1-2 weeks | 1 week |\\n\\n### Time to See Results\\n\\n| Phase | Timeline |\\n|-------|----------|\\n| First leads | Immediately with existing traffic or paid |\\n| Organic traffic growth | 2-6 months (SEO) |\\n| Meaningful lead volume | 1-3 months |\\n| Measurable impact on pipeline | 3-6 months |\\n| Full ROI assessment | 6-12 months |\\n\\n**Note**: These benchmarks are general guidelines. Your actual results depend on audience, niche, traffic volume, and offer quality. Start measuring from day one and build your own benchmarks.\\n\"},\n {\"skill\":\"lead-magnets\",\"ref\":\"format-guide\",\"body\":\"# Lead Magnet Format Guide\\n\\nDetailed creation guidance for each lead magnet format.\\n\\n## Contents\\n- Ebooks & Guides\\n- Checklists\\n- Cheat Sheets\\n- Templates & Spreadsheets\\n- Swipe Files\\n- Mini-Courses\\n- Quizzes & Assessments\\n- Webinars & Workshops\\n\\n---\\n\\n## Ebooks & Guides\\n\\n**Best for**: Building authority, deep education, awareness-stage leads\\n\\n**Structure**:\\n1. Title page with professional design\\n2. Table of contents\\n3. Introduction — frame the problem, set expectations\\n4. 3-7 chapters — one key concept per chapter\\n5. Summary — recap key takeaways\\n6. CTA — next step toward your product\\n\\n**Guidelines**:\\n- Ideal length: 10-25 pages (shorter is fine if valuable)\\n- Include visuals: charts, diagrams, screenshots\\n- Use callout boxes for key stats or quotes\\n- End each chapter with a quick takeaway\\n- Don't pad — density beats length\\n\\n**Tools**: Canva, Google Docs → PDF, Notion export, Designrr, Beacon.by\\n\\n---\\n\\n## Checklists\\n\\n**Best for**: Process-oriented tasks, quick wins, implementation help\\n\\n**Structure**:\\n- Title: \\\"[Number]-Point [Topic] Checklist\\\"\\n- Numbered or checkbox items\\n- Group into logical sections if 10+ items\\n- Brief explanation per item (1-2 sentences)\\n\\n**Guidelines**:\\n- Keep to 1-2 pages\\n- Use actionable language (\\\"Verify X\\\", \\\"Set up Y\\\", \\\"Remove Z\\\")\\n- Order by workflow sequence or priority\\n- Make it printable — clean layout, generous spacing\\n- Include a \\\"done\\\" checkbox for each item\\n\\n**What works**: Step-by-step processes, audit criteria, launch checklists, setup guides\\n\\n---\\n\\n## Cheat Sheets\\n\\n**Best for**: Reference material, shortcuts, quick-lookup information\\n\\n**Structure**:\\n- One page (two pages max)\\n- Organized by category or workflow\\n- Dense but scannable\\n- Visual hierarchy with headers and grouping\\n\\n**Guidelines**:\\n- Optimize for quick reference, not reading\\n- Use tables, grids, or columns\\n- Include formulas, shortcuts, or code snippets\\n- Design for printing or saving as desktop reference\\n- Bold the most important items\\n\\n**What works**: Keyboard shortcuts, formula references, terminology glossaries, decision matrices\\n\\n---\\n\\n## Templates & Spreadsheets\\n\\n**Best for**: Repeatable processes, planning, tracking\\n\\n### Spreadsheet Templates (Google Sheets / Excel)\\n- Include a \\\"How to Use\\\" tab with instructions\\n- Pre-fill with example data\\n- Use data validation for dropdown fields\\n- Add conditional formatting for visual cues\\n- Lock formula cells, leave input cells editable\\n- Include a \\\"Make a Copy\\\" link (Google Sheets)\\n\\n### Notion Templates\\n- Provide a duplicate link\\n- Include a getting-started guide\\n- Pre-populate with example content\\n- Use Notion's database features (views, filters, relations)\\n- Keep it simple — don't over-engineer\\n\\n### Document Templates\\n- Provide in multiple formats (Google Doc, Word, PDF)\\n- Include placeholder text with [BRACKETS] for customization\\n- Add inline instructions in a different color\\n- Make it immediately usable with minimal editing\\n\\n**Key principle**: Templates should be usable within 5 minutes of downloading.\\n\\n---\\n\\n## Swipe Files\\n\\n**Best for**: Inspiration, examples, learning from others\\n\\n**Structure**:\\n- Curated collection of 15-50 examples\\n- Organized by category, type, or use case\\n- Each example includes:\\n - The example itself (screenshot, text, link)\\n - Why it works (2-3 bullet annotations)\\n - How to adapt it (1-2 sentences)\\n\\n**Guidelines**:\\n- Quality over quantity — curate ruthlessly\\n- Add your analysis, don't just collect\\n- Organize for browsing (categories, tags)\\n- Update periodically with fresh examples\\n- Credit original sources\\n\\n**What works**: Email subject lines, landing pages, ad copy, CTAs, onboarding flows, pricing pages\\n\\n---\\n\\n## Mini-Courses\\n\\n### Email-Based Mini-Courses\\n- 3-5 emails delivered over 5-7 days\\n- One lesson per email, one concept per lesson\\n- Each email: teach → example → exercise\\n- Progressive difficulty (build on previous lessons)\\n- Final email: summary + CTA for product or next step\\n\\n### Video-Based Mini-Courses\\n- 3-5 videos, 5-15 minutes each\\n- Host on unlisted YouTube, Loom, or course platform\\n- Deliver links via email drip\\n- Include worksheets or exercises per lesson\\n- More personal — builds stronger connection\\n\\n**Cadence**: Every 1-2 days. Don't stretch too thin or compress too tight.\\n\\n**Key principle**: Each lesson should deliver standalone value. If someone only watches lesson 2, they should still learn something useful.\\n\\n---\\n\\n## Quizzes & Assessments\\n\\n**Best for**: Engagement, segmentation, personalized results\\n\\n**Question Design**:\\n- 5-10 questions (sweet spot: 7)\\n- Multiple choice only — no open-ended\\n- Questions should feel insightful, not obvious\\n- Progress indicator (\\\"Question 3 of 7\\\")\\n\\n**Result Segmentation**:\\n- 3-5 result categories\\n- Each result: name, description, personalized recommendations\\n- Tailor follow-up emails by result type\\n- Share-worthy result format (\\\"I got: Growth Stage Marketer!\\\")\\n\\n**Implementation**: Gate results behind email capture. The quiz itself is ungated — the personalized results require an email.\\n\\n**For building interactive quizzes**: See **free-tools** skill for technical implementation guidance.\\n\\n---\\n\\n## Webinars & Workshops\\n\\n### Live Webinars\\n- 30-45 minutes teaching + 15 minutes Q&A\\n- Structure: Hook → Teach (3 key points) → Demo/example → CTA\\n- Promote 1-2 weeks in advance\\n- Send 3 reminder emails (confirmation, day before, 1 hour before)\\n- Record for replay (extends value)\\n\\n### Evergreen Webinars\\n- Pre-recorded, available on demand\\n- Same structure as live but tighter editing\\n- Always-on lead generation\\n- Gate with email registration\\n- Automated follow-up sequence\\n\\n**Follow-up**: Send replay link + summary + CTA within 24 hours. Continue with nurture sequence.\\n\\n**Key principle**: Teach something genuinely useful. A webinar that's just a sales pitch will damage trust.\\n\"},\n {\"skill\":\"marketing-ideas\",\"ref\":\"ideas-by-category\",\"body\":\"# The 139 Marketing Ideas\\n\\nComplete list of proven marketing approaches organized by category.\\n\\n## Contents\\n- Content & SEO (1-10)\\n- Competitor & Comparison (11-13)\\n- Free Tools & Engineering (14-22)\\n- Paid Advertising (23-34)\\n- Social Media & Community (35-44)\\n- Email Marketing (45-53)\\n- Partnerships & Programs (54-64)\\n- Events & Speaking (65-72)\\n- PR & Media (73-76)\\n- Launches & Promotions (77-86)\\n- Product-Led Growth (87-96)\\n- Content Formats (97-109)\\n- Unconventional & Creative (110-122)\\n- Platforms & Marketplaces (123-130)\\n- International & Localization (131-132)\\n- Developer & Technical (133-136)\\n- Audience-Specific (137-139)\\n\\n## Content & SEO (1-10)\\n\\n1. **Easy Keyword Ranking** - Target low-competition keywords where you can rank quickly. Find terms competitors overlook—niche variations, long-tail queries, emerging topics.\\n\\n2. **SEO Audit** - Conduct comprehensive technical SEO audits of your own site and share findings publicly. Document fixes and improvements to build authority.\\n\\n3. **Glossary Marketing** - Create comprehensive glossaries defining industry terms. Each term becomes an SEO-optimized page targeting \\\"what is X\\\" searches.\\n\\n4. **Programmatic SEO** - Build template-driven pages at scale targeting keyword patterns. Location pages, comparison pages, integration pages—any pattern with search volume.\\n\\n5. **Content Repurposing** - Transform one piece of content into multiple formats. Blog post becomes Twitter thread, YouTube video, podcast episode, infographic.\\n\\n6. **Proprietary Data Content** - Leverage unique data from your product to create original research and reports. Data competitors can't replicate creates linkable assets.\\n\\n7. **Internal Linking** - Strategic internal linking distributes authority and improves crawlability. Build topical clusters connecting related content.\\n\\n8. **Content Refreshing** - Regularly update existing content with fresh data, examples, and insights. Refreshed content often outperforms new content.\\n\\n9. **Knowledge Base SEO** - Optimize help documentation for search. Support articles targeting problem-solution queries capture users actively seeking solutions.\\n\\n10. **Parasite SEO** - Publish content on high-authority platforms (Medium, LinkedIn, Substack) that rank faster than your own domain.\\n\\n---\\n\\n## Competitor & Comparison (11-13)\\n\\n11. **Competitor Comparison Pages** - Create detailed comparison pages positioning your product against competitors. \\\"[Your Product] vs [Competitor]\\\" pages capture high-intent searchers.\\n\\n12. **Marketing Jiu-Jitsu** - Turn competitor weaknesses into your strengths. When competitors raise prices, launch affordability campaigns.\\n\\n13. **Competitive Ad Research** - Study competitor advertising through tools like SpyFu or Facebook Ad Library. Learn what messaging resonates.\\n\\n---\\n\\n## Free Tools & Engineering (14-22)\\n\\n14. **Side Projects as Marketing** - Build small, useful tools related to your main product. Side projects attract users who may later convert.\\n\\n15. **Engineering as Marketing** - Build free tools that solve real problems. Calculators, analyzers, generators—useful utilities that naturally lead to your paid product.\\n\\n16. **Importers as Marketing** - Build import tools for competitor data. \\\"Import from [Competitor]\\\" reduces switching friction.\\n\\n17. **Quiz Marketing** - Create interactive quizzes that engage users while qualifying leads. Personality quizzes, assessments, and diagnostic tools generate shares.\\n\\n18. **Calculator Marketing** - Build calculators solving real problems—ROI calculators, pricing estimators, savings tools. Calculators attract links and rank well.\\n\\n19. **Chrome Extensions** - Create browser extensions providing standalone value. Chrome Web Store becomes another distribution channel.\\n\\n20. **Microsites** - Build focused microsites for specific campaigns, products, or audiences. Dedicated domains can rank faster.\\n\\n21. **Scanners** - Build free scanning tools that audit or analyze something. Website scanners, security checkers, performance analyzers.\\n\\n22. **Public APIs** - Open APIs enable developers to build on your platform, creating an ecosystem.\\n\\n---\\n\\n## Paid Advertising (23-34)\\n\\n23. **Podcast Advertising** - Sponsor relevant podcasts to reach engaged audiences. Host-read ads perform especially well.\\n\\n24. **Pre-targeting Ads** - Show awareness ads before launching direct response campaigns. Warm audiences convert better.\\n\\n25. **Facebook Ads** - Meta's detailed targeting reaches specific audiences. Test creative variations and leverage retargeting.\\n\\n26. **Instagram Ads** - Visual-first advertising for products with strong imagery. Stories and Reels ads capture attention.\\n\\n27. **Twitter Ads** - Reach engaged professionals discussing industry topics. Promoted tweets and follower campaigns.\\n\\n28. **LinkedIn Ads** - Target by job title, company size, and industry. Premium CPMs justified by B2B purchase intent.\\n\\n29. **Reddit Ads** - Reach passionate communities with authentic messaging. Transparency wins on Reddit.\\n\\n30. **Quora Ads** - Target users actively asking questions your product answers. Intent-rich environment.\\n\\n31. **Google Ads** - Capture high-intent search queries. Brand terms, competitor terms, and category terms.\\n\\n32. **YouTube Ads** - Video ads with detailed targeting. Pre-roll and discovery ads reach users consuming related content.\\n\\n33. **Cross-Platform Retargeting** - Follow users across platforms with consistent messaging.\\n\\n34. **Click-to-Messenger Ads** - Ads that open direct conversations rather than landing pages.\\n\\n---\\n\\n## Social Media & Community (35-44)\\n\\n35. **Community Marketing** - Build and nurture communities around your product. Slack groups, Discord servers, Facebook groups.\\n\\n36. **Quora Marketing** - Answer relevant questions with genuine expertise. Include product mentions where naturally appropriate.\\n\\n37. **Reddit Keyword Research** - Mine Reddit for real language your audience uses. Discover pain points and desires.\\n\\n38. **Reddit Marketing** - Participate authentically in relevant subreddits. Provide value first.\\n\\n39. **LinkedIn Audience** - Build personal brands on LinkedIn for B2B reach. Thought leadership builds authority.\\n\\n40. **Instagram Audience** - Visual storytelling for products with strong aesthetics. Behind-the-scenes and user stories.\\n\\n41. **X Audience** - Build presence on X/Twitter through consistent value. Threads and insights grow followings.\\n\\n42. **Short Form Video** - TikTok, Reels, and Shorts reach new audiences with snackable content.\\n\\n43. **Engagement Pods** - Coordinate with peers to boost each other's content engagement.\\n\\n44. **Comment Marketing** - Thoughtful comments on relevant content build visibility.\\n\\n---\\n\\n## Email Marketing (45-53)\\n\\n45. **Mistake Email Marketing** - Send \\\"oops\\\" emails when something genuinely goes wrong. Authenticity generates engagement.\\n\\n46. **Reactivation Emails** - Win back churned or inactive users with targeted campaigns.\\n\\n47. **Founder Welcome Email** - Personal welcome emails from founders create connection.\\n\\n48. **Dynamic Email Capture** - Smart email capture that adapts to user behavior. Exit intent, scroll depth triggers.\\n\\n49. **Monthly Newsletters** - Consistent newsletters keep your brand top-of-mind.\\n\\n50. **Inbox Placement** - Technical email optimization for deliverability. Authentication and list hygiene.\\n\\n51. **Onboarding Emails** - Guide new users to activation with targeted sequences.\\n\\n52. **Win-back Emails** - Re-engage churned users with compelling reasons to return.\\n\\n53. **Trial Reactivation** - Expired trials aren't lost causes. Targeted campaigns can recover them.\\n\\n---\\n\\n## Partnerships & Programs (54-64)\\n\\n54. **Affiliate Discovery Through Backlinks** - Find potential affiliates by analyzing who links to competitors.\\n\\n55. **Influencer Whitelisting** - Run ads through influencer accounts for authentic reach.\\n\\n56. **Reseller Programs** - Enable agencies to resell your product. White-label options create distribution partners.\\n\\n57. **Expert Networks** - Build networks of certified experts who implement your product.\\n\\n58. **Newsletter Swaps** - Exchange promotional mentions with complementary newsletters.\\n\\n59. **Article Quotes** - Contribute expert quotes to journalists. HARO connects experts with writers.\\n\\n60. **Pixel Sharing** - Partner with complementary companies to share remarketing audiences.\\n\\n61. **Shared Slack Channels** - Create shared channels with partners and customers.\\n\\n62. **Affiliate Program** - Structured commission programs for referrers.\\n\\n63. **Integration Marketing** - Joint marketing with integration partners.\\n\\n64. **Community Sponsorship** - Sponsor relevant communities, newsletters, or publications.\\n\\n---\\n\\n## Events & Speaking (65-72)\\n\\n65. **Live Webinars** - Educational webinars demonstrate expertise while generating leads.\\n\\n66. **Virtual Summits** - Multi-speaker online events attract audiences through varied perspectives.\\n\\n67. **Roadshows** - Take your product on the road to meet customers directly.\\n\\n68. **Local Meetups** - Host or attend local meetups in key markets.\\n\\n69. **Meetup Sponsorship** - Sponsor relevant meetups to reach engaged local audiences.\\n\\n70. **Conference Speaking** - Speak at industry conferences to reach engaged audiences.\\n\\n71. **Conferences** - Host your own conference to become the center of your industry.\\n\\n72. **Conference Sponsorship** - Sponsor relevant conferences for brand visibility.\\n\\n---\\n\\n## PR & Media (73-76)\\n\\n73. **Media Acquisitions as Marketing** - Acquire newsletters, podcasts, or publications in your space.\\n\\n74. **Press Coverage** - Pitch newsworthy stories to relevant publications.\\n\\n75. **Fundraising PR** - Leverage funding announcements for press coverage.\\n\\n76. **Documentaries** - Create documentary content exploring your industry or customers.\\n\\n---\\n\\n## Launches & Promotions (77-86)\\n\\n77. **Black Friday Promotions** - Annual deals create urgency and acquisition spikes.\\n\\n78. **Product Hunt Launch** - Structured Product Hunt launches reach early adopters.\\n\\n79. **Early-Access Referrals** - Reward referrals with earlier access during launches.\\n\\n80. **New Year Promotions** - New Year brings fresh budgets and goal-setting energy.\\n\\n81. **Early Access Pricing** - Launch with discounted early access tiers.\\n\\n82. **Product Hunt Alternatives** - Launch on BetaList, Launching Next, AlternativeTo.\\n\\n83. **Twitter Giveaways** - Engagement-boosting giveaways that require follows or retweets.\\n\\n84. **Giveaways** - Strategic giveaways attract attention and capture leads.\\n\\n85. **Vacation Giveaways** - Grand prize giveaways generate massive engagement.\\n\\n86. **Lifetime Deals** - One-time payment deals generate cash and users.\\n\\n---\\n\\n## Product-Led Growth (87-96)\\n\\n87. **Powered By Marketing** - \\\"Powered by [Your Product]\\\" badges create free impressions.\\n\\n88. **Free Migrations** - Offer free migration services from competitors.\\n\\n89. **Contract Buyouts** - Pay to exit competitor contracts.\\n\\n90. **One-Click Registration** - Minimize signup friction with OAuth options.\\n\\n91. **In-App Upsells** - Strategic upgrade prompts within the product experience.\\n\\n92. **Newsletter Referrals** - Built-in referral programs for newsletters.\\n\\n93. **Viral Loops** - Product mechanics that naturally encourage sharing.\\n\\n94. **Offboarding Flows** - Optimize cancellation flows to retain or learn.\\n\\n95. **Concierge Setup** - White-glove onboarding for high-value accounts.\\n\\n96. **Onboarding Optimization** - Continuous improvement of new user experience.\\n\\n---\\n\\n## Content Formats (97-109)\\n\\n97. **Playlists as Marketing** - Create Spotify playlists for your audience.\\n\\n98. **Template Marketing** - Offer free templates users can immediately use.\\n\\n99. **Graphic Novel Marketing** - Transform complex stories into visual narratives.\\n\\n100. **Promo Videos** - High-quality promotional videos showcase your product.\\n\\n101. **Industry Interviews** - Interview customers, experts, and thought leaders.\\n\\n102. **Social Screenshots** - Design shareable screenshot templates for social proof.\\n\\n103. **Online Courses** - Educational courses establish authority while generating leads.\\n\\n104. **Book Marketing** - Author a book establishing expertise in your domain.\\n\\n105. **Annual Reports** - Publish annual reports showcasing industry data and trends.\\n\\n106. **End of Year Wraps** - Personalized year-end summaries users want to share.\\n\\n107. **Podcasts** - Launch a podcast reaching audiences during commutes.\\n\\n108. **Changelogs** - Public changelogs showcase product momentum.\\n\\n109. **Public Demos** - Live product demonstrations showing real usage.\\n\\n---\\n\\n## Unconventional & Creative (110-122)\\n\\n110. **Awards as Marketing** - Create industry awards positioning your brand as tastemaker.\\n\\n111. **Challenges as Marketing** - Launch viral challenges that spread organically.\\n\\n112. **Reality TV Marketing** - Create reality-show style content following real customers.\\n\\n113. **Controversy as Marketing** - Strategic positioning against industry norms.\\n\\n114. **Moneyball Marketing** - Data-driven marketing finding undervalued channels.\\n\\n115. **Curation as Marketing** - Curate valuable resources for your audience.\\n\\n116. **Grants as Marketing** - Offer grants to customers or community members.\\n\\n117. **Product Competitions** - Sponsor competitions using your product.\\n\\n118. **Cameo Marketing** - Use Cameo celebrities for personalized messages.\\n\\n119. **OOH Advertising** - Out-of-home advertising—billboards, transit ads.\\n\\n120. **Marketing Stunts** - Bold, attention-grabbing marketing moments.\\n\\n121. **Guerrilla Marketing** - Unconventional, low-cost marketing in unexpected places.\\n\\n122. **Humor Marketing** - Use humor to stand out and create memorability.\\n\\n---\\n\\n## Platforms & Marketplaces (123-130)\\n\\n123. **Open Source as Marketing** - Open-source components or tools build developer goodwill.\\n\\n124. **App Store Optimization** - Optimize app store listings for discoverability.\\n\\n125. **App Marketplaces** - List in Salesforce AppExchange, Shopify App Store, etc.\\n\\n126. **YouTube Reviews** - Get YouTubers to review your product.\\n\\n127. **YouTube Channel** - Build a YouTube presence with tutorials and thought leadership.\\n\\n128. **Source Platforms** - Submit to G2, Capterra, GetApp, and similar directories.\\n\\n129. **Review Sites** - Actively manage presence on review platforms.\\n\\n130. **Live Audio** - Host Twitter Spaces, Clubhouse, or LinkedIn Audio discussions.\\n\\n---\\n\\n## International & Localization (131-132)\\n\\n131. **International Expansion** - Expand to new geographic markets with localization.\\n\\n132. **Price Localization** - Adjust pricing for local purchasing power.\\n\\n---\\n\\n## Developer & Technical (133-136)\\n\\n133. **Investor Marketing** - Market to investors for portfolio introductions.\\n\\n134. **Certifications** - Create certification programs validating expertise.\\n\\n135. **Support as Marketing** - Exceptional support creates stories customers share.\\n\\n136. **Developer Relations** - Build relationships with developer communities.\\n\\n---\\n\\n## Audience-Specific (137-139)\\n\\n137. **Two-Sided Referrals** - Reward both referrer and referred.\\n\\n138. **Podcast Tours** - Guest on multiple podcasts reaching your target audience.\\n\\n139. **Customer Language** - Use the exact words your customers use in marketing.\\n\"}\n];\n",[],[463,774,784],"fcc9369a-5d6d-11f1-b895-1607ee4eb77e","ref_6.ts","fcc9385c-5d6d-11f1-b895-1607ee4eb77e",665,["D",1780286239896],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_6: SkillRef[] = [\n {\"skill\":\"customer-research\",\"ref\":\"source-guides\",\"body\":\"# Customer Research — Source Guides\\n\\nDetailed, source-by-source playbooks for gathering customer intelligence from online watering holes.\\n\\n---\\n\\n## Reddit Research\\n\\n### Finding the Right Subreddits\\n\\nStart by identifying where your ICP spends time, not where your product is discussed.\\n\\n**Discovery methods:**\\n- Search `site:reddit.com \\\"[job title] tools\\\"` or `site:reddit.com \\\"[problem category] software\\\"`\\n- Use [subreddit search tools](https://www.reddit.com/subreddits/search) with problem-space keywords\\n- Look at what subreddits show up in Google results when you search ICP problems\\n- Check what subreddits competitors' customers mention in reviews\\n\\n**Common high-value subreddits by category:**\\n- B2B SaaS: r/sales, r/marketing, r/entrepreneur, r/startups, r/smallbusiness\\n- Dev tools: r/programming, r/devops, r/webdev, r/cscareerquestions\\n- Analytics/data: r/analytics, r/dataengineering, r/BusinessIntelligence\\n- Marketing: r/PPC, r/SEO, r/emailmarketing, r/content_marketing\\n- HR/recruiting: r/recruiting, r/humanresources, r/jobs\\n- Finance/ops: r/accounting, r/financialplanning, r/projectmanagement\\n\\n### Search Operators\\n\\n```\\nsite:reddit.com/r/[subreddit] \\\"[keyword]\\\"\\nsite:reddit.com \\\"[problem]\\\" \\\"recommend\\\" OR \\\"suggestion\\\" OR \\\"alternative\\\"\\nsite:reddit.com \\\"[competitor name]\\\" \\\"vs\\\" OR \\\"alternative\\\" OR \\\"switched\\\"\\n```\\n\\n### What to Look For\\n\\n**High-signal post types:**\\n- \\\"What tools do you use for X?\\\" → reveals alternatives and vocab\\n- \\\"Frustrated with [competitor], looking for alternatives\\\" → reveals pain and switching triggers\\n- \\\"How do you handle X?\\\" → reveals workflow and workarounds\\n- \\\"Is [your category] worth it?\\\" → reveals objections and evaluation criteria\\n- Complaint threads about competitors → reveals gaps you might fill\\n\\n**What to extract:**\\n- The exact problem described in the post\\n- Top-voted solutions (what do practitioners actually recommend?)\\n- Complaints about existing solutions in comments\\n- The language used — note specific words and phrases\\n- Upvote patterns — consensus vs. controversy\\n\\n### Tools\\n- Reddit's native search (limited but fast)\\n- Google: `site:reddit.com [query]` (better results)\\n- Pullpush.io — search archived Reddit posts (good for older threads)\\n\\n---\\n\\n## G2 and Review Site Mining\\n\\n### Your Own Product Reviews\\n\\nRead in this order for maximum signal:\\n\\n1. **3-star reviews** — these are the most honest. Customer liked it enough to stay but felt something was missing.\\n2. **1-star reviews** — understand the failure modes. Separate product issues from support/onboarding issues.\\n3. **5-star reviews** — extract the \\\"what they love\\\" language. These are your proof points.\\n4. **4-star reviews** — often contain \\\"the only thing I wish…\\\" buried in praise.\\n\\n**What to extract:**\\n- What they say they use it *for* (the job to be done)\\n- What they say is hardest or most frustrating\\n- What they compare it to (\\\"coming from [X]\\\", \\\"better than [Y]\\\")\\n- Industry and role signals in reviewer profiles\\n\\n### Competitor Reviews on G2\\n\\nThe 4-star competitor reviews are gold — customers who like the product but still have complaints.\\n\\n**G2 structure to exploit:**\\n- \\\"What do you like best?\\\" → their strengths (your battlecard intel)\\n- \\\"What do you dislike?\\\" → their weaknesses (your opportunities)\\n- \\\"What problems are you solving?\\\" → the job to be done\\n\\n**Capterra** has similar structure. **Trustpilot** skews B2C. **AppSumo** reviews are useful for SMB/prosumer SaaS.\\n\\n### Review Mining Template\\n\\nFor each competitor's 4-star reviews, extract:\\n\\n| Category | Notes |\\n|----------|-------|\\n| Job to be done | Why do they use the product? |\\n| Top praise | What do they love (and might be hard for you to match)? |\\n| Top complaint | What frustrates them? |\\n| Switching context | Did they mention switching from something else? |\\n| Unmet need | \\\"I wish it could…\\\" or \\\"It would be better if…\\\" |\\n\\n---\\n\\n## Indie Hackers and Product Hunt\\n\\n### Indie Hackers\\n\\nStrong signal for founder/builder/SMB ICP.\\n\\n**Where to look:**\\n- \\\"Ask IH\\\" posts: questions about problems your product solves\\n- Milestone posts: when founders describe their stack, they reveal tool preferences and pain\\n- Comment threads on product launches in your category\\n\\n**Search:** `site:indiehackers.com \\\"[problem]\\\"` or use IH's native search.\\n\\n### Product Hunt\\n\\n**Discussion tabs** on competing products are a research goldmine:\\n- Questions asked = pre-sales concerns = objections\\n- Comments = early adopter reactions = leading indicators of reception\\n- \\\"Alternatives to X\\\" collections reveal the competitive landscape as users see it\\n\\n---\\n\\n## Hacker News\\n\\nStrong signal for technical/developer ICP. Skews toward builders and skeptics.\\n\\n**High-value searches:**\\n- `site:news.ycombinator.com \\\"[competitor or category]\\\"`\\n- HN \\\"Ask HN: best tools for X\\\" threads\\n- \\\"Show HN\\\" posts for competitors — read the skeptical comments\\n\\n**What's different about HN:**\\n- Users are more likely to critique underlying architecture and business model\\n- Strong opinions about pricing models (especially anything subscription-based)\\n- First principles objections you might not hear elsewhere\\n\\n---\\n\\n## LinkedIn Research\\n\\n### Posts and Comments\\n\\nSearch for posts by practitioners describing their workflows:\\n- \\\"[Role] at [company size]\\\" + problem keyword\\n- \\\"We used to [old way] but now we [new way]\\\" stories\\n- Posts asking for tool recommendations get comments from active buyers\\n\\n### Job Postings\\n\\nA job posting is a company's admission of a pain point.\\n\\n**What to look for:**\\n- What tools are listed as \\\"nice to have\\\" vs. \\\"required\\\"? (reveals stack and adjacent tools)\\n- What metrics and outcomes are mentioned in the role description?\\n- What does the role spend most of its time doing? (reveals the job to be done)\\n\\n**Search:** `site:linkedin.com/jobs \\\"[role title]\\\" \\\"[relevant tool or category]\\\"`\\n\\n---\\n\\n## YouTube Comments\\n\\n### Finding High-Signal Videos\\n\\n- Tutorial videos for problems your product solves\\n- \\\"Best tools for X in [year]\\\" roundup videos\\n- Competitor product demos and walkthroughs\\n\\n**What to look for in comments:**\\n- \\\"Does this work for [specific use case]?\\\" → edge cases and unmet needs\\n- \\\"I tried this but…\\\" → failure points\\n- \\\"What about [competitor]?\\\" → active evaluation\\n- Timestamps with questions → confusion points in the workflow\\n\\n---\\n\\n## Twitter / X Research\\n\\n### Search Operators\\n\\n```\\n\\\"[competitor]\\\" -filter:replies min_faves:10\\n\\\"[problem keyword]\\\" \\\"anyone know\\\" OR \\\"recommend\\\" OR \\\"alternative\\\"\\n\\\"[category] is broken\\\" OR \\\"frustrated with [category]\\\"\\n```\\n\\n### What to Find\\n\\n- Real-time complaints about competitors\\n- Practitioners discussing their stack\\n- Influencers/thought leaders your ICP follows (useful for distribution)\\n\\n---\\n\\n## Blog Post and Forum Research\\n\\n### Comparison Content\\n\\nGoogle: `\\\"[competitor 1] vs [competitor 2]\\\"` or `\\\"best [category] software [year]\\\"`\\n\\nRead the comments on these posts — people who find comparison content are actively evaluating. Their comments are questions your sales process should answer.\\n\\n### Niche Communities\\n\\n- **Slack communities**: Many industries have public or semi-public Slack groups. Search \\\"[industry] Slack community\\\".\\n- **Discord servers**: Growing for developer and creator communities.\\n- **Facebook Groups**: Still strong for SMB, e-commerce, agency, and coach/consultant ICP.\\n- **Circle/Mighty Networks communities**: Check if there are paid communities in your ICP's space.\\n\\n---\\n\\n## B2C and Consumer App Research\\n\\nB2C research requires different sources than B2B SaaS. Consumer buyers don't congregate on LinkedIn or G2 — they leave traces in app stores, social media, and communities built around the activity your product serves.\\n\\n### App Store Reviews (iOS App Store / Google Play)\\n\\nOne of the richest unfiltered sources for mobile/consumer products.\\n\\n**Read in this order:**\\n1. **1-2 star reviews** — failure modes, unmet expectations, frustration peaks\\n2. **3-star reviews** — honest tradeoffs and \\\"it's good but…\\\" feedback\\n3. **5-star reviews** — what they love in their own words (proof points and positioning)\\n\\n**What to extract:**\\n- What job they hired the app to do (\\\"I use this to…\\\")\\n- The moment it stopped working for them\\n- What they compared it to or switched from\\n- Emotional language — \\\"I love how…\\\", \\\"I'm so frustrated that…\\\"\\n\\n**Search tip:** Sort by \\\"Most Recent\\\" to get fresh signal, then \\\"Most Critical\\\" for pain themes.\\n\\n### Amazon Reviews (for physical products or software with Amazon presence)\\n\\nSame priority order as app stores: 3-star reviews first.\\n\\n**G2 analog for consumer SaaS**: Trustpilot, Sitejabber, and product-specific review aggregators.\\n\\n### Reddit Consumer Communities\\n\\nB2C Reddit is highly vertical — go to the hobby/lifestyle subreddit, not the general ones.\\n\\n**Examples by product type:**\\n- Fitness apps: r/running, r/loseit, r/fitness, r/MyFitnessPal\\n- Personal finance: r/personalfinance, r/financialindependence, r/ynab\\n- Productivity/notes: r/productivity, r/Notion, r/ObsidianMD\\n- Travel: r/travel, r/solotravel, r/digitalnomad\\n- Parenting: r/Parenting, r/beyondthebump, r/daddit\\n\\n**Search pattern:** `site:reddit.com/r/[community] \\\"[app name OR problem]\\\"`\\n\\n### TikTok and Instagram Comments\\n\\nHigh-signal for consumer products with visual/lifestyle appeal.\\n\\n**How to find signal:**\\n- Search TikTok for \\\"[product name] review\\\" or \\\"is [product] worth it\\\"\\n- Watch the top 5-10 videos; read ALL comments — not just likes\\n- On Instagram, check tagged posts from real users (not brand posts)\\n\\n**What to extract:**\\n- Questions in comments = unmet needs or unclear positioning\\n- \\\"Does this work for…?\\\" = jobs they want to hire it for\\n- \\\"I switched from X\\\" comments = switching triggers\\n- Complaints about price, missing features, or broken promises\\n\\n### YouTube Comments (Consumer)\\n\\nSame approach as B2B but different video types:\\n\\n- \\\"X app honest review\\\" or \\\"X app after 6 months\\\"\\n- \\\"Best [category] apps [year]\\\" comparison videos\\n- Unboxing or \\\"setup\\\" videos for hardware/physical products\\n\\nComments on review videos are especially valuable — these are people actively in the consideration phase.\\n\\n### Consumer Community Platforms\\n\\n- **Facebook Groups**: Still dominant for many consumer verticals (parenting, fitness, local services, hobbies)\\n- **Discord servers**: Growing for gaming, creator tools, productivity, crypto, lifestyle communities\\n- **Nextdoor**: Useful for local service businesses\\n- **Quora**: Long-form questions reveal decision anxiety and evaluation criteria\\n\\n---\\n\\n## SparkToro (Audience Intelligence)\\n\\nSparkToro is a behavioral audience research tool. Instead of mining individual posts and comments, it aggregates clickstream, search, and social data to show what your audience does at scale — what they read, watch, listen to, follow, and search for.\\n\\n### When to Use SparkToro vs. Manual Research\\n\\n- **SparkToro first** when you need to understand where your ICP spends time, what content they consume, and which influencers they follow — it answers these questions in seconds with aggregated data\\n- **Manual research first** (Reddit, G2, communities) when you need raw language, exact quotes, emotional context, and the \\\"why\\\" behind behavior\\n- **Best together**: Use SparkToro to identify which podcasts, subreddits, and websites matter, then go mine those sources manually for voice-of-customer language\\n\\n### Key Queries to Run\\n\\n**By competitor:**\\n- \\\"People who follow @competitor\\\" — reveals shared audience affinities\\n- \\\"People who visit competitor.com\\\" — shows what else they consume\\n\\n**By audience description:**\\n- \\\"People who frequently talk about [topic]\\\" — finds audience behaviors\\n- \\\"People whose bio contains [job title]\\\" — profiles a role-based segment\\n\\n**By your own audience:**\\n- \\\"People who visit yourdomain.com\\\" — understand your actual audience\\n- Compare against competitor audience profiles to find gaps\\n\\n### What to Extract\\n\\n| Data Type | What It Tells You | Use It For |\\n|-----------|------------------|------------|\\n| Top websites visited | Where your audience reads | Content partnerships, guest posting targets |\\n| Top podcasts | What they listen to | Podcast guesting, sponsorship decisions |\\n| Top YouTube channels | What they watch | Video content strategy, ad placements |\\n| Top subreddits | Where they discuss | Community participation, Reddit ad targeting |\\n| Search keywords | What they Google | SEO and content topic planning |\\n| AI prompt topics | What they ask AI tools | Emerging content opportunities |\\n| Social accounts followed | Who influences them | Influencer partnerships, co-marketing |\\n| Demographics | Who they are | Persona building, ad targeting |\\n\\n### Source Weighting\\n\\nSparkToro data is aggregated and anonymized — it shows patterns, not individual opinions. Treat it as:\\n- **High confidence** for behavioral data (what they visit, follow, search for)\\n- **Medium confidence** for demographic data (self-reported, may be incomplete)\\n- **Not a substitute** for qualitative research (doesn't capture language, emotions, or the \\\"why\\\")\\n\\n### Limitations\\n\\n- Free tier: 5 reports/month, shallow results (top 5–10)\\n- No public API — all research done through web interface\\n- Skews English-language, US-centric\\n- Shows what audiences do, not why — pair with qualitative sources\\n\\nSee [tools/integrations/sparktoro.md](../../../tools/integrations/sparktoro.md) for full tool details and pricing.\\n\\n---\\n\\n## Organizing Your Research\\n\\nUse a simple tagging system across all sources:\\n\\n| Tag | Meaning |\\n|-----|---------|\\n| `#pain` | A problem or frustration |\\n| `#trigger` | An event that prompted the search |\\n| `#outcome` | What success looks like |\\n| `#language` | Exact phrases worth using in copy |\\n| `#alternative` | Another solution they considered or use |\\n| `#objection` | Reason to hesitate or not buy |\\n| `#competitor` | Anything about a competing product |\\n\\nKeep a running doc with columns: Source | Date | Quote | Tags | Notes\\n\\nAfter 20-30 entries, patterns will emerge. Look for quotes that appear in multiple unrelated sources — those are your highest-confidence insights.\\n\\n---\\n\\n## Source Reliability and Confidence Scoring\\n\\nNot all sources carry equal weight. Use this guide when assigning confidence labels.\\n\\n### Source Weighting\\n\\n| Source | Signal Strength | Bias to Note |\\n|--------|----------------|--------------|\\n| Customer interviews (unprompted) | Very high | Small sample; selection bias toward engaged customers |\\n| Win/loss interviews | High | Recent memory only; rationalization common |\\n| App store / G2 reviews | High | Skews toward strong opinions (love or hate) |\\n| Reddit / community posts | Medium-high | Skews technical, skeptical, vocal minorities |\\n| Support tickets | Medium | Skews toward problems; silent majority not represented |\\n| Survey (open-ended) | Medium | Primed by question framing |\\n| Survey (multiple choice) | Low-medium | Artifacts of the options you provided |\\n| NPS verbatims | Medium | Correlates with score; prompted by the survey moment |\\n| YouTube/TikTok comments | Medium | Skews toward engaged viewers; social performance |\\n| SparkToro audience data | Medium-high | Aggregated behavioral data; strong for \\\"what\\\" but not \\\"why\\\" |\\n| Job postings | Low-medium | Aspirational, not necessarily reflective of current pain |\\n\\n### Confidence Labels in Practice\\n\\nWhen presenting insights, lead with confidence:\\n\\n```\\n[HIGH CONFIDENCE] Customers feel overwhelmed by manual reporting — appears in 12 of 20 interviews,\\n4 Reddit threads, and is the #1 complaint in 3-star G2 reviews. Consistent across SMB and mid-market.\\n\\n[MEDIUM CONFIDENCE] Customers compare us to spreadsheets more than to direct competitors —\\nmentioned in 6 interviews and 3 Reddit threads, but not yet seen in review data.\\n\\n[LOW CONFIDENCE] Enterprise buyers may have procurement concerns — mentioned by 2 interviewees\\nfrom companies 500+. Needs more signal before acting on it.\\n```\\n\\n### Recency Window\\n\\n- **Use as primary source**: Data from the last 12 months\\n- **Use with caution**: 12-24 months (product and market may have shifted)\\n- **Use only for baseline context**: 2+ years old\\n\\nWhen a theme appears consistently across old and new data, that's a durable signal worth acting on.\\n\"},\n {\"skill\":\"directory-submissions\",\"ref\":\"directory-list\",\"body\":\"# Directory List — Full Reference\\n\\nCanonical list of directories organized by tier. DR values are approximate and drift over time — verify via Ahrefs or Moz before building a plan around them.\\n\\n**Column legend:**\\n- **DR** — Domain Rating (Ahrefs). Higher = more link equity passed.\\n- **Dofollow** — Whether the backlink passes SEO value. Nofollow listings still matter for referral traffic and brand signals.\\n- **Cost** — Free unless noted.\\n\\n---\\n\\n## Tier 1 — Flagship Launch Platforms\\n\\nSubmit only during launch week. These are time-sensitive with limited re-submission windows.\\n\\n| Directory | DR | Dofollow | Cost | Notes |\\n|---|---|---|---|---|\\n| **Product Hunt** | 91 | Yes | Free | The anchor event. Requires 3-week warm-up. 2026 algorithm weights comment quality over upvotes. Launch Tue/Wed/Thu at 12:01 AM PT. |\\n| **Hacker News (Show HN)** | 91 | Nofollow | Free | Only if you have a genuine technical angle. Post title format: \\\"Show HN: [Product] — [hook]\\\". Moderator death penalty for hype. |\\n| **BetaList** | 64 | Yes | Free (paid expedite ~$99) | Best for pre-launch waitlist building. Submission → 2–4 week queue unless expedited. |\\n| **Launching Next** | ~30 | Yes | Free | Editorial curation — needs a compelling story. |\\n| **Fazier** | ~30 | Yes | Free | Daily ranking with much lower competition than PH. Achievable #1. |\\n| **Uneed** | ~40 | Yes | Free | Curated, smaller audience, quality backlink. |\\n| **Microlaunch** | ~30 | Yes | Free | Month-long visibility vs one-day spike. |\\n| **OpenHunts** | ~25 | Yes | Free | Indie-maker friendly, reports 14%+ conversion rates. |\\n| **DevHunt** | ~35 | Yes | Free | Dev-focused. Best fit for developer tools and technical products. |\\n| **PeerPush** | ~25 | Yes | Free | Similar to Fazier. Low competition. |\\n| **LaunchVault** | ~20 | Yes | Free | Anti-VC positioning. Good for bootstrapped narrative. |\\n| **What Launched Today** | ~20 | Yes | Free | Guaranteed visibility on launch day regardless of votes. |\\n| **Firsto** | ~25 | Yes | Free tier | Sustained discovery, not one-day spike. |\\n| **GetByte** | ~20 | Yes | Free | Lightweight listing + promotional support. |\\n| **Best of Web** | ~30 | Yes | Free | Easy fast submission, free dofollow. |\\n| **Tiny Launch** | ~20 | Yes | Free | Lightweight, fast approval. |\\n| **PitchWall** | ~25 | Yes | Free | Indie-hacker friendly. |\\n\\n---\\n\\n## Tier 2 — Startup / SaaS / Software Directories\\n\\nSubmit during launch week and continue rolling submissions thereafter.\\n\\n| Directory | DR | Dofollow | Cost | Notes |\\n|---|---|---|---|---|\\n| **AlternativeTo** | 79 | Nofollow | Free | Massive SEO value despite nofollow. Submit as alternative to your top 4 competitors. |\\n| **SaaSHub** | 77 | Yes | Free | Ranks well for \\\"[tool] alternatives\\\" queries. High intent. |\\n| **G2** | 92 | Yes | Free listing | 10 reviews required for Grid appearance. Paid badges start at $2,999/yr. |\\n| **Capterra** | 93 | Yes | Free listing | Owned by G2 (acquired Feb 2026). Reviews drive everything. |\\n| **GetApp** | 78 | Yes | Free | Auto-syncs from Capterra in some cases. Owned by G2. |\\n| **SourceForge** | 92 | Yes | Free | Legacy but still high DR. Trivial to list. |\\n| **Slashdot** | ~88 | Yes | Free | Legacy but high DR. Company profile submission. |\\n| **Startup Stash** | ~50 | Yes | Free | Curated, organized by startup need. |\\n| **SideProjectors** | ~35 | Yes | Free | Discovery + marketplace. Community-driven. |\\n| **F6S** | 65 | Yes | Free | Startup platform used by accelerators. |\\n| **Stackshare** | ~60 | Yes | Free | Dev-centric. Show your tech stack. |\\n| **Resource.fyi** | ~40 | Yes | Free | Curated for designers/devs/marketers. |\\n| **Shipybara** | ~30 | Yes | Free | Shows which companies use your tool. |\\n| **TrustRadius** | 72 | Yes | Free | Smaller but respected B2B review platform. |\\n| **Crozdesk** | ~55 | Yes | Free | Feeds into Gartner ecosystem. |\\n| **Software Advice** | 88 | Yes | Free | Gartner property. Auto-syncs with Capterra in some categories. |\\n| **TheSaaSDirectory** | 88 | Yes | Free | SaaS-specific directory. Good categorization. |\\n| **Tech.co** | 80 | Yes | Free | Startup/SaaS directory + media. |\\n| **Taalk** | 80 | Yes | Free | Startup directory. |\\n| **Startup Fame** | 77 | Yes | Free | Startup showcase directory. |\\n| **Indie Hackers** | 76 | Yes | Free | Build-in-public community + product directory. |\\n| **Slant** | 75 | Yes | Free | \\\"What is the best...\\\" recommendation platform. |\\n| **Gust** | 75 | Yes | Free | Startup/investor platform. Profile with links. |\\n| **Inc42** | 75 | Yes | Free | Indian startup media + directory. |\\n| **Wefunder** | 76 | Yes | Free | Equity crowdfunding. Product profile with links. |\\n| **Startups.com** | 68 | Yes | Free | Startup community + resources. |\\n| **IndieHustles** | 66 | Yes | Free | Indie SaaS directory. |\\n| **SaaSWorthy** | 65 | Yes | Free | SaaS review/comparison site. |\\n| **ToolsFine** | 65 | Yes | Free | SaaS tool directory. |\\n| **Bizcommunity** | 65 | Yes | Free | Business news + directory. |\\n| **StartUs** | 62 | Yes | Free | Startup directory + insights. |\\n| **Today Launches** | 60 | Yes | Free | Daily launch directory. |\\n| **StartupBuffer** | 57 | Yes | Free | Startup promotion platform. |\\n| **Feedough** | 55 | Yes | Free | Startup resources + directory. |\\n| **Indie Hacker Tools** | 55 | Yes | Free | Tools for indie hackers. |\\n| **Open Launch** | 55 | Yes | Free | Product launch directory. |\\n| **New SaaSly** | 52 | Yes | Free | New SaaS product directory. |\\n| **Business Software** | 49 | Yes | Free | Business software directory. |\\n| **Promote Project** | 47 | Yes | Free | Project promotion directory. |\\n| **FiveTaco** | 47 | Yes | Free | SaaS tool directory. |\\n| **Cuspera** | 45 | Yes | Free | SaaS comparison platform. |\\n| **BetaBound** | 45 | Yes | Free | Beta testing community + directory. |\\n| **Makerthrive** | 45 | Yes | Free | Maker community + tools. |\\n| **StartupTracker** | 44 | Yes | Free | Startup tracking directory. |\\n| **BusinessHunt** | 43 | Yes | Free | Business product directory. |\\n| **Launched.io** | 40 | Yes | Free | Launch directory. |\\n| **ProfitHunt** | 40 | Yes | Free | Profitable startup directory. |\\n| **10words** | 40 | Yes | Free | SaaS directory (10-word descriptions). |\\n| **TrustMRR** | 40 | Yes | Free | MRR-verified startup directory. |\\n| **OpenClawDir** | 35 | Yes | Free | Open directory. |\\n| **Build Voyage** | 33 | Yes | Free | Startup builder directory. |\\n| **AlphaDigits** | 32 | Yes | Free | SaaS directory. |\\n\\n---\\n\\n## Tier 3 — AI Tool Directories\\n\\nRelevant only for AI-native products. Submit during weeks 1–3.\\n\\n### Tier 3A — Flagship AI directories\\n\\n| Directory | DR | Monthly Traffic | Notes |\\n|---|---|---|---|\\n| **There's An AI For That (TAAFT)** | 76 | 2M+ | Largest AI directory. Task-based search. Worth the effort to list well. |\\n| **Futurepedia** | 70 | 1M+ | 5,000+ tools, 54 categories. Matt Wolfe YouTube (2M+ subs) drives traffic. |\\n| **Toolify.ai** | 71 | 500K+ | 26K+ tools, 450+ categories. Tracks traffic trends. |\\n| **Future Tools (futuretools.io)** | 69 | 400K+ | Curated by Matt Wolfe. Smaller but influential. |\\n| **AI Tools Neilpatel** | 91 | n/a | Highest DR free AI directory. |\\n| **Good AI Tools** | 66 | n/a | Curated, quality over quantity. |\\n| **NewTools.site** | 51 | n/a | Dofollow backlink for every approved submission. |\\n\\n### Tier 3B — Mid-tier AI directories\\n\\n| Directory | Est. DR | Notes |\\n|---|---|---|\\n| **aitools.inc** | ~66 | \\\"10x your output\\\" positioning. |\\n| **AIStage** | ~66 | Includes open source + news. |\\n| **AItrendytools** | ~69 | Comprehensive listing. |\\n| **Grabon AI Directory** | ~70 | High DR, broad audience. |\\n| **TopAI.tools** | ~60 | Task-based search similar to TAAFT. |\\n| **Supertools** | ~61 | Clean interface, good categorization. |\\n| **AI Tools Directory** (aitoolsdirectory.com) | ~55 | Curated; featured placement available. |\\n| **AI Tools Love** | ~25 | Comparison-focused. |\\n| **AIChief** | ~35 | Business-focused. |\\n| **LogicBalls** | ~40 | 3,500+ verified tools. |\\n| **SaasAITools** | ~30 | SaaS + AI crossover. |\\n| **PoweredByAI** | ~35 | Growing directory with newsletter reach. |\\n| **TheAISurf** | ~30 | Newer, actively promoting submissions. |\\n| **Aixyz** | ~30 | 1,500+ tools, smart filters. |\\n| **AI Pedia Hub** | ~40 | \\\"Largest directory, updated daily.\\\" |\\n| **Dofollow.Tools** | ~30 | Explicitly free dofollow backlinks. |\\n| **AIBacklinkList** | ~25 | Aggregated list of 2500+ AI backlink opportunities. |\\n| **AI Scout** | ~25 | Emerging, less competition. |\\n| **AiMatchPro** | ~20 | Use-case search. |\\n| **GPTForge** | ~30 | Domain created 2025 — DR 88 from source list is implausible. Verify via Ahrefs. |\\n| **AI Tools Guide** | 77 | Curated AI tools directory. |\\n| **AIToolly** | 69 | AI tool discovery. |\\n| **All The AI Tools** | 66 | Comprehensive AI tool listing. |\\n| **Aiforme.wiki** | 66 | AI tool wiki/directory. |\\n| **Noxilo** | 66 | AI tools directory. |\\n| **AI Generation** | 55 | AI tools directory. |\\n| **Every AI** | 55 | AI tool aggregator. |\\n| **BAI.tools** | 53 | AI tools directory. |\\n| **The Rundown Tools** | 40 | AI newsletter's tool directory. |\\n| **AI NavHub** | 38 | AI navigation directory. |\\n| **WhatTheAI** | 35 | AI tools directory. |\\n| **ToolAI** | 31 | AI tools directory. |\\n| **LLM Relevance** | 30 | LLM-focused directory. |\\n\\n---\\n\\n## Tier 4 — AI Agent & MCP Server Registries\\n\\nRelevant only if the product exposes agent capabilities or MCP servers. These are a real moat for AI-native tools — traditional SaaS products cannot list here.\\n\\n| Directory | Category | Notes |\\n|---|---|---|\\n| **AI Agents List (aiagentslist.com)** | Agents | Hosts the 593+ MCP server directory. |\\n| **Glama.ai MCP servers** | MCP | 20K+ security-graded MCP servers. A/B/C/F grades matter — optimize for a good grade. |\\n| **APITracker MCP directory** | MCP | 110+ servers, 90 official integrations. |\\n| **Linux Foundation MCP Registry** | MCP | Canonical registry (PR-based submission, low volume but high signal). Anthropic donated MCP to LF in Dec 2025. |\\n| **AI Agent Store** | Agents | Compare agents, platforms, frameworks. |\\n| **AI Agents Base** | Agents | All-in-one directory. |\\n| **AI Agents Directory** | Agents | Specialized, updated daily. |\\n| **AI Agents Verse** | Agents | Curated directory. |\\n| **AgentHunter** | Agents | \\\"Discover the best AI agents.\\\" |\\n| **Add AI Directory** | Agents | Catalogs agents + tools. |\\n| **AI Agents Live** | Agents | Discovery + sharing. |\\n| **AI Agents Marketplace** | Agents | Organized by 300+ human role equivalents. |\\n\\n---\\n\\n## Tier 5 — No-Code Directories\\n\\nRelevant for no-code platforms and builder tools.\\n\\n| Directory | Est. DR | Notes |\\n|---|---|---|\\n| **NoCodeFinder** | ~45 | Accepts submissions. |\\n| **No Code MBA Tools Directory** | ~55 | Categorized by project type. |\\n| **We Are No Code Tools Repository** | ~40 | Curated. |\\n| **NoCodeList** | ~30 | — |\\n| **NoCodeDevs** | ~25 | — |\\n| **NoCode.Tech** | ~35 | — |\\n| **MakerPad / Zapier** | ~62 | Now owned by Zapier. No-code tool directory. |\\n| **NoCodeFounders** | ~45 | No-code community + forum. |\\n\\n---\\n\\n## Tier 6 — \\\"Best of\\\" Listicles (Editorial Outreach)\\n\\nNot directories per se — these are blog posts on high-DR domains that you get included in via cold outreach. Often more valuable than directories because they combine a dofollow backlink with editorial trust + in-market buyer traffic + AI citation weight.\\n\\n**Search patterns to find opportunities:**\\n- `\\\"best [category] tools\\\" 2026`\\n- `\\\"best [competitor] alternative\\\"`\\n- `\\\"top AI [category]\\\"`\\n- `\\\"[category] tools review\\\"`\\n\\n**Outreach template (short):**\\n> Hey [name], saw your post on [best X tools]. We launched [product] recently — thought it might be worth a mention. Happy to give you a free account + credits for readers. Here's a 60s demo: [link]. No worries if not a fit.\\n\\n**Target:** 10 inclusions in 30 days. Each = dofollow backlink from DR 40–70 + referral traffic + AI citation fuel.\\n\\n---\\n\\n## Tier 7 — Integration Marketplaces\\n\\nOnly relevant once the product has integrations. These are the highest-DR backlinks available — worth engineering effort just to land them.\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **Zapier App Directory** | 91 | Requires working Zapier integration. |\\n| **HubSpot App Marketplace** | 93 | Requires HubSpot app. |\\n| **Slack App Directory** | 89 | Requires Slack integration. |\\n| **Airtable Marketplace** | 82 | Requires Airtable integration. |\\n| **Notion Integrations Gallery** | 88 | Requires Notion integration. |\\n| **Make (Integromat)** | ~70 | Requires Make module. |\\n| **Pipedream** | ~70 | Requires Pipedream action. |\\n\\n---\\n\\n## Tier 8 — Profile & Content Platforms\\n\\nCreate a profile or publish content on these high-DR platforms to earn a dofollow backlink. These are not traditional directories — they're content and identity platforms where your profile or published content links back to your site. Highest DR backlinks available without building integrations.\\n\\n| Platform | DR | Category | Type | Notes |\\n|---|---|---|---|---|\\n| **WordPress.com** | 100 | Any | Blog | Create a free blog, link to main site in posts and profile. |\\n| **Blogger** | 100 | Any | Blog | Google property. Free blog with dofollow links. |\\n| **Tumblr** | 99 | Design | Blog | Highest DR blog platform. Project blog or microblog. |\\n| **GitHub** | 98 | Tech | Code host | Profile + repo README links. Every software product should have this. |\\n| **SoundCloud** | 96 | Music | Profile | Niche — relevant for audio/music products. |\\n| **Weebly** | 95 | Any | Blog | Free site builder with dofollow profile link. |\\n| **SlideShare** | 95 | Any | Content | Upload pitch decks, guides, presentations. |\\n| **Flickr** | 95 | Photography | Profile | Product screenshot galleries with profile link. |\\n| **GitLab** | 94 | Tech | Code host | Profile link. Mirror repos if open source. |\\n| **eBay Stores** | 94 | E-commerce | Profile | Niche — relevant for physical/digital goods. |\\n| **Etsy** | 93 | E-commerce | Profile | Niche — templates, digital downloads. |\\n| **Substack** | 93 | Tech | Newsletter | Publish product updates, thought leadership. High-intent readers. |\\n| **Bitbucket** | 93 | Tech | Code host | Profile link. Atlassian property. |\\n| **Scribd** | 93 | Any | Content | Upload whitepapers, guides, case studies. |\\n| **Disqus** | 93 | Professional | Profile | Profile with website link. Comment on industry blogs. |\\n| **Behance** | 93 | Design | Profile | Portfolio/project links. Best for design-adjacent products. |\\n| **Pastebin** | 93 | Tech | Code host | Code snippets with profile link. |\\n| **Patreon** | 93 | Creator | Profile | Creator page with product links. |\\n| **Imgur** | 93 | Any | Profile | Image hosting with profile link. |\\n| **Dun & Bradstreet** | 93 | B2B | Directory | Business credibility. Feeds AI training corpora. |\\n| **Ghost.org** | 92 | Any | Blog | Publish content with dofollow links. |\\n| **Evernote** | 92 | Any | Content | Public notebooks with links. |\\n| **Issuu** | 92 | Any | Content | Upload marketing PDFs, brochures, reports. |\\n| **CodePen** | 92 | Tech | Profile | Front-end demos and profile link. |\\n| **Kaggle** | 92 | AI | Profile | AI/data science community. Notebooks with links. |\\n| **Houzz** | 92 | Home | Profile | Niche — home/interior products. |\\n| **LiveJournal** | 91 | Any | Blog | Legacy but high DR. Blog with dofollow links. |\\n| **Bandcamp** | 91 | Music | Profile | Niche — audio products. |\\n| **Dev.to** | 90 | Tech | Blog | Technical articles with dofollow links. Cross-post with canonical URL. |\\n| **Gravatar** | 90 | Professional | Profile | Profile with website link. Quick setup. |\\n| **Replit** | 90 | Tech | Code host | Profile link. Interactive demos. |\\n| **CodeProject** | 90 | Tech | Blog | Technical articles for dev audience. |\\n| **Jimdo** | 89 | Any | Blog | Free site builder with profile link. |\\n| **Calameo** | 89 | Any | Content | Digital publishing platform. Upload PDFs. |\\n| **Buy Me a Coffee** | 88 | Creator | Profile | Creator page with product links. |\\n| **ArtStation** | 88 | Design | Profile | Portfolio for creative/design products. |\\n| **500px** | 88 | Photography | Profile | Product imagery with profile link. |\\n| **IndiaMART** | 87 | B2B | Profile | Indian B2B marketplace. Niche but high DR. |\\n| **Strikingly** | 87 | Any | Blog | Free one-page site with backlink. |\\n| **Hashnode** | 85 | Tech | Blog | Dev blogging. Custom domain support. Dofollow links. |\\n| **About.me** | 85 | Professional | Profile | One-page profile. Quick dofollow backlink. |\\n| **Mixcloud** | 85 | Music | Profile | Niche — audio/podcast products. |\\n| **4Shared** | 85 | Any | Content | File sharing with profile link. |\\n| **HubPages** | 84 | Any | Blog | Article publishing platform. |\\n| **AppSumo** | 84 | E-commerce | Marketplace | SaaS deals marketplace. Great for launch visibility + backlink. |\\n| **TeachersPayTeachers** | 84 | Education | Profile | Niche — education products. |\\n| **AuthorStream** | 70 | Any | Content | Presentation sharing. |\\n| **Model Mayhem** | 72 | Design | Profile | Niche — creative industry. |\\n| **Penzu** | 60 | Any | Blog | Online journal with profile link. |\\n| **Crevado** | 50 | Design | Profile | Portfolio platform. |\\n| **MyFolio** | 55 | Design | Profile | Portfolio platform. |\\n\\n---\\n\\n## Tier 9 — Local Business & General Directories\\n\\nRelevant for products with a physical presence, local customer base, or business address. Also useful for any product wanting pure DR-building backlinks from established directories.\\n\\n| Directory | DR | Category | Notes |\\n|---|---|---|---|\\n| **Manta** | 76 | Local business | US business directory. Free listing. |\\n| **ActiveSearchResults** | 74 | General | Search engine directory. |\\n| **Hotfrog** | 72 | Local business | International business directory. |\\n| **Spoke** | 70 | B2B | Business profile directory. |\\n| **Locanto** | 70 | General | Classifieds + business listings. International. |\\n| **MerchantCircle** | 68 | Local business | US small business directory. |\\n| **Just Landed** | 65 | Local business | International directory. |\\n| **Showmelocal** | 64 | Local business | US local search directory. |\\n| **Cylex** | 64 | Local business | International business directory. |\\n| **Brownbook** | 63 | Local business | Global business directory. |\\n| **Tupalo** | 62 | Local business | European business directory. |\\n| **WebWiki** | 60 | General | Website directory with reviews. |\\n| **iBegin** | 60 | Local business | US business directory. |\\n| **CitySquares** | 55 | Local business | US local business directory. |\\n| **eLocal** | 55 | Local business | US service provider directory. |\\n| **2FindLocal** | 53 | Local business | US local directory. |\\n| **Chamber of Commerce** | 50 | Local business | Business directory + resources. |\\n| **FindUsLocal** | 50 | Local business | Local search directory. |\\n| **ezlocal** | 50 | Local business | US local business listings. |\\n| **Yellow Pages Goes Green** | 49 | Local business | Eco-friendly business directory. |\\n| **Where To?** | 46 | Local business | Local discovery directory. |\\n\\n---\\n\\n## Tier 10 — Forums & Communities\\n\\nCreate a profile and participate in relevant communities. Most give dofollow profile links. Value comes from both the backlink and referral traffic from genuine participation. Follow the 90/10 rule: 90% helpful, 10% promotional.\\n\\n| Forum | DR | Category | Notes |\\n|---|---|---|---|\\n| **Strava Clubs** | 90 | Fitness | Niche — fitness/health products only. |\\n| **Foursquare** | 90 | Hospitality | Business listing with dofollow link. |\\n| **SitePoint Forums** | 89 | Tech | Web dev community. Genuine participation required. |\\n| **Mumsnet Forums** | 85 | Family | Niche — family/parenting products. Large UK audience. |\\n| **Digital Point** | 82 | Marketing | SEO/marketing forum. |\\n| **WebmasterWorld** | 77 | Marketing | SEO/webmaster community. High editorial standards. |\\n| **BlackHatWorld** | 77 | Marketing | SEO/marketing forum. Despite the name, has legitimate discussions. |\\n| **GrowthHackers** | 76 | Marketing | Growth marketing community. Dofollow articles + profile. |\\n| **Warrior Forum** | 73 | Marketing | Internet marketing community. |\\n| **Apsense** | 72 | Marketing | Business networking + marketing forum. |\\n| **ActiveRain** | 70 | Real estate | Niche — real estate industry. |\\n| **Quibblo** | 55 | General | Quiz/poll community with profile links. |\\n\\n---\\n\\n## Tier 11 — Press Release, Article & Blog Directory Sites\\n\\nPublish articles or press releases to earn dofollow backlinks. Best for product launches, funding announcements, major feature releases. Some accept any topic, others are PR-specific.\\n\\n### Article & Blog Directories\\n\\n| Site | DR | Type | Notes |\\n|---|---|---|---|\\n| **EzineArticles** | 80 | Article | Established article directory. Editorial review. |\\n| **Feedspot** | 80 | Blog directory | Blog discovery + RSS aggregation. Submit your blog. |\\n| **Alltop** | 73 | Blog directory | Guy Kawasaki's blog aggregator. |\\n| **ArticlesBase** | 70 | Article | Article publishing platform. |\\n| **Blogarama** | 64 | Blog directory | Blog directory with categories. |\\n| **Sooper Articles** | 60 | Article | Article submission site. |\\n| **OnToplist** | 60 | Blog directory | Blog ranking directory. |\\n| **BlogEngage** | 55 | Blog directory | Blog promotion community. |\\n| **BizSugar** | 55 | Business | Small business content sharing. |\\n| **TechPluto** | 50 | Marketing | Tech/marketing blog directory. |\\n\\n### Press Release Distribution\\n\\n| Site | DR | Notes |\\n|---|---|---|\\n| **PRLog** | 80 | Free press release distribution. Good reach. |\\n| **PR.com** | 77 | Free + paid press releases. Business directory too. |\\n| **OpenPR** | 72 | Free international press release distribution. |\\n| **1888 Press Release** | 69 | Free press release site. |\\n| **NewswireToday** | 65 | Free press release distribution. |\\n| **Online PR News** | 62 | Free press release distribution. |\\n| **PR Free** | 62 | Free press release site. |\\n\\n### Marketing & General Directories\\n\\n| Site | DR | Notes |\\n|---|---|---|\\n| **SubmissionWebDirectory** | 61 | General web directory. |\\n| **Site Promotion Directory** | 46 | Marketing-focused directory. |\\n| **Semfirms** | 45 | Marketing services directory. |\\n| **CabinetM** | 45 | Marketing technology directory. |\\n| **Cold Email Kit** | 44 | Email marketing directory. |\\n| **Directory LDM Studio** | 40 | General directory. |\\n| **Quality Internet Directory** | 39 | General web directory. |\\n| **ProofStories** | 32 | Marketing stories/case studies. |\\n\\n---\\n\\n## Tier 12 — Social Bookmarking & Curation\\n\\nBookmark or curate content with dofollow links. Lower effort than publishing full articles. Most useful for building diverse backlink profile.\\n\\n| Platform | DR | Notes |\\n|---|---|---|\\n| **Scoop.it** | 91 | Content curation platform. Create topic pages with links. |\\n| **Diigo** | 85 | Social bookmarking + annotation. Profile + bookmark links. |\\n| **Pearltrees** | 84 | Visual content curation. Organize links into collections. |\\n| **BibSonomy** | 70 | Academic bookmarking. Best for research/data products. |\\n| **Folkd** | 64 | Social bookmarking. Tag and share links. |\\n\\n---\\n\\n## Tier 13 — Niche Vertical Directories\\n\\nIndustry-specific directories. Only submit if your product genuinely fits the vertical — forced listings get rejected and waste time.\\n\\n### Legal\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **Justia** | 85 | Legal services directory. |\\n| **Lawyers.com** | 82 | Legal directory. |\\n| **HG.org** | 75 | Legal resources directory. |\\n\\n### Home & Construction\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **Porch** | 80 | Home services marketplace. |\\n| **BuildZoom** | 73 | Construction/contractor directory. |\\n| **Tradify (FreeIndex)** | 55 | UK trades directory. |\\n| **iBuildNew** | 45 | Australian home building directory. |\\n\\n### Hospitality & Food\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **AllMenus** | 76 | Restaurant directory. |\\n\\n### Design & Creative\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **LandBook** | 72 | Web design inspiration gallery. Submit landing pages. |\\n| **Curated.design** | 52 | Design inspiration directory. |\\n| **Webdesign Inspiration** | 45 | Website design showcase. |\\n\\n### Health & Fitness\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **Wellness.com** | 60 | Health & wellness directory. |\\n| **YogaTrail** | 55 | Yoga/wellness directory. |\\n| **MassageTherapy (AMBP)** | 45 | Massage therapy directory. |\\n| **Athlinks** | 72 | Fitness/race results. Profile with links. |\\n| **Fit Pro Directory** | 40 | Fitness professional directory. |\\n\\n### Real Estate\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **Placester** | 60 | Real estate marketing directory. |\\n\\n### B2B & International\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **Sulekha** | 73 | Indian business directory. |\\n| **EU-Business** | 46 | European business directory. |\\n\\n### Events\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| **Evensi Events** | 62 | Event discovery platform. |\\n\\n### Education\\n\\n| Directory | DR | Notes |\\n|---|---|---|\\n| *(TeachersPayTeachers listed in Tier 8 — Profile Platforms)* | | |\\n\\n---\\n\\n## Verification\\n\\nAfter any submission goes live, verify the backlink exists and is dofollow. You can:\\n\\n1. **Manual:** Open the listing, right-click your product link, \\\"Inspect\\\" → check for `rel=\\\"nofollow\\\"` or `rel=\\\"ugc\\\"`. If absent, the link is dofollow.\\n2. **curl:** `curl -sIL https://directory.com/your-listing | grep -i link`\\n3. **SEO tools:** Ahrefs Site Explorer → Backlinks → filter by this directory's domain.\\n\\n**Re-verify quarterly.** Directories sometimes change all outbound links to nofollow without warning — if DR stops moving, check whether your biggest inbound links have silently flipped.\\n\"},\n {\"skill\":\"directory-submissions\",\"ref\":\"positioning-variations\",\"body\":\"# Positioning Variations Library\\n\\nDirectory audiences respond to different framings. Never copy-paste the same description everywhere — AI engines penalize duplicate content, and each directory type rewards a different opener.\\n\\nUse this library to generate per-tier variants. Swap `[product]`, `[category]`, `[competitors]`, `[use-case]`, and `[audience]` with the real values.\\n\\n---\\n\\n## Framework: Lead Sentence Varies by Tier\\n\\n| Tier | Lead sentence pattern | Why |\\n|---|---|---|\\n| Startup / launch | \\\"[Product] is the easiest way to [outcome] for [audience].\\\" | Founders scan for outcome clarity. |\\n| SaaS directory | \\\"[Product] is the [differentiator] alternative to [competitors].\\\" | Catches \\\"[competitor] alternative\\\" search intent. |\\n| AI directory | \\\"[Product] uses [AI capability] to [outcome].\\\" | TAAFT/Futurepedia audiences explicitly want AI. |\\n| Agent / MCP | \\\"[Product] is an MCP-native / agent-native [category].\\\" | Niche but high-intent. Ruling-out competitors. |\\n| No-code | \\\"[Product] lets you build [output] without code.\\\" | Audience values speed, not technical depth. |\\n| Dev tool | \\\"[Product] is a [technical category] with [differentiator].\\\" | Devs want substance upfront. |\\n| B2B review | \\\"[Product] helps [audience] [measurable business outcome].\\\" | Reviewers want ROI language. |\\n\\n---\\n\\n## Template: Startup / Launch Directories\\n\\n**Target:** Product Hunt, BetaList, Fazier, Uneed, DevHunt, Microlaunch, OpenHunts, LaunchVault, Firsto, PitchWall\\n\\n**Tagline (under 10 words):**\\n> The [differentiator] way to [outcome] for [audience].\\n\\n**Short description (60 chars):**\\n> [Outcome-focused one-liner with product name]\\n\\n**Long description (150 words):**\\n> [Product] is the easiest way to [outcome] for [audience]. Built for teams who [pain point], [product] removes [friction] by [how].\\n>\\n> Unlike [competitor category], [product] [key differentiator 1] and [key differentiator 2]. You can [action 1] in under [timeframe], [action 2] without [limitation], and [action 3] that would normally require [cost or technical skill].\\n>\\n> We built [product] because [founder origin story in one sentence]. It's now used by [audience examples] to [use case examples].\\n>\\n> Try it free at [url]. No credit card, no setup.\\n\\n**Tags:** [product category], [audience type], [use case 1], [use case 2], [differentiator], [tech]\\n\\n---\\n\\n## Template: SaaS / Software Directories\\n\\n**Target:** AlternativeTo, SaaSHub, G2, Capterra, GetApp, SourceForge, Slashdot, Startup Stash, F6S\\n\\n**Tagline:**\\n> The [differentiator] alternative to [top competitors].\\n\\n**Long description:**\\n> [Product] is a [differentiator] alternative to [competitor 1], [competitor 2], and [competitor 3] — built for [audience] who need [gap the competitors don't fill].\\n>\\n> Where [competitor 1] [limitation 1] and [competitor 2] [limitation 2], [product] [solves]. You get [feature 1], [feature 2], and [feature 3] in a single workspace, at [pricing relative to competitors].\\n>\\n> Key features:\\n> • [Feature 1] — [benefit]\\n> • [Feature 2] — [benefit]\\n> • [Feature 3] — [benefit]\\n> • [Feature 4] — [benefit]\\n> • [Integration 1], [Integration 2], [Integration 3] integrations\\n>\\n> Trusted by [audience examples]. Start free at [url].\\n\\n**Tags:** [competitor] alternative, [category], [audience], [differentiator], [top 3 features]\\n\\n---\\n\\n## Template: AI Directories\\n\\n**Target:** TAAFT, Futurepedia, Toolify, Future Tools, aitools.inc, AIStage, LogicBalls, SaasAITools\\n\\n**Tagline:**\\n> AI-powered [category] for [audience].\\n\\n**Long description:**\\n> [Product] is an AI-powered [category] that [core AI capability]. It uses [specific models / techniques] to [outcome] — so [audience] can [job to be done] in a fraction of the time.\\n>\\n> What makes it AI-first:\\n> • [AI feature 1] — [what it does] using [model/approach]\\n> • [AI feature 2] — [what it does]\\n> • [AI feature 3] — [what it does]\\n> • [AI feature 4] — [what it does]\\n>\\n> [Product] is built on [tech stack] and supports [models/providers]. Use cases: [use case 1], [use case 2], [use case 3], [use case 4].\\n>\\n> Free tier available. No API keys required to start.\\n\\n**Tags:** AI [category], [AI capability 1], [AI capability 2], AI for [audience], [use case 1], [use case 2], [LLM provider], [differentiator]\\n\\n---\\n\\n## Template: Agent / MCP Registries\\n\\n**Target:** Glama, APITracker, Linux Foundation MCP Registry, AI Agents List, AI Agent Store, AgentHunter\\n\\n**Tagline:**\\n> MCP-native [category] for AI agents.\\n\\n**Long description:**\\n> [Product] is an MCP-native [category] that lets AI agents [capability]. It exposes [MCP server capabilities] via the Model Context Protocol, so agents in Claude, ChatGPT, Cursor, and any MCP-compatible client can [actions].\\n>\\n> MCP capabilities:\\n> • [Tool 1] — [what the agent can do]\\n> • [Tool 2] — [what the agent can do]\\n> • [Tool 3] — [what the agent can do]\\n> • [Resource 1] — [context surfaced]\\n> • [Prompt 1] — [pre-built prompt]\\n>\\n> Authentication: [auth method]. Transports: stdio, HTTP, SSE. Security: [security posture].\\n>\\n> Installation: [one-line install command]. Docs: [docs URL].\\n\\n**Tags:** MCP, MCP server, AI agent, agent [category], Claude integration, Model Context Protocol, [domain], [auth type]\\n\\n---\\n\\n## Template: No-Code Directories\\n\\n**Target:** NoCodeFinder, No Code MBA Tools Directory, We Are No Code, NoCode.Tech\\n\\n**Tagline:**\\n> Build [output] without code.\\n\\n**Long description:**\\n> [Product] lets you build [output] without writing code. Drag, drop, or describe what you want and [product] handles the rest — [technical concept 1] and [technical concept 2] are automatic.\\n>\\n> What you can build:\\n> • [Example project 1] — built in [timeframe]\\n> • [Example project 2] — built in [timeframe]\\n> • [Example project 3] — built in [timeframe]\\n>\\n> No-code friendly features:\\n> • [Visual feature 1]\\n> • [Visual feature 2]\\n> • [AI-assisted feature]\\n> • [Pre-built templates]\\n>\\n> Start free. No credit card. Templates included.\\n\\n**Tags:** no code, no-code [category], visual [tool], drag and drop, [output type], [audience type]\\n\\n---\\n\\n## Template: Dev / Technical Directories\\n\\n**Target:** DevHunt, Stackshare, GitHub, Dev.to, Hacker News Show HN\\n\\n**Tagline:**\\n> [Technical category] with [technical differentiator].\\n\\n**Long description:**\\n> [Product] is a [technical category] built on [tech stack]. It solves [technical problem] by [technical approach].\\n>\\n> Architecture:\\n> • [Component 1] — [tech used]\\n> • [Component 2] — [tech used]\\n> • [Component 3] — [tech used]\\n>\\n> Why it's different: [technical insight or novel approach]. We chose [trade-off] because [reason].\\n>\\n> Open source: [yes/no/partial]. Self-hostable: [yes/no]. License: [license].\\n>\\n> API: [REST / GraphQL / MCP / gRPC]. SDKs: [languages]. Docs: [url].\\n\\n**Tags:** [language], [framework], [category], open source, API, [tech stack component], [architecture approach]\\n\\n---\\n\\n## Template: B2B Review Platforms\\n\\n**Target:** G2, Capterra, TrustRadius, GetApp, Gartner Digital Markets, Crozdesk\\n\\n**Tagline:**\\n> [Business outcome] for [audience].\\n\\n**Long description:**\\n> [Product] helps [audience] [achieve measurable business outcome]. Teams use it to [use case 1], [use case 2], and [use case 3] — reducing [metric] by [percentage] and increasing [metric] by [percentage].\\n>\\n> Key benefits:\\n> • [Business benefit 1] with [how measured]\\n> • [Business benefit 2] with [how measured]\\n> • [Business benefit 3] with [how measured]\\n>\\n> Integrations: [enterprise integrations — HubSpot, Salesforce, Slack, etc.]\\n>\\n> Security: [SOC 2 / GDPR / compliance posture]. Support: [support tier]. Pricing: [pricing range].\\n>\\n> Trusted by [customer logos / company size]. Case studies at [url].\\n\\n**Tags:** [business use case], [vertical], [audience role], [compliance], enterprise [category], [integration 1]\\n\\n---\\n\\n## Category Tag Library\\n\\nPull 5–8 tags per submission from the relevant sections. Never repeat the exact same tag set across two directories in the same tier.\\n\\n### Universal\\n[category], [audience], [differentiator], [use case], AI, no-code, SaaS, [tech stack]\\n\\n### Industry\\nB2B, B2C, DTC, ecommerce, fintech, edtech, healthtech, martech, devtools, productivity, creator tools, agency tools\\n\\n### Job-to-be-done\\nlead generation, lead qualification, customer onboarding, product recommendation, sales enablement, marketing automation, survey, assessment, calculator, quiz, intake form\\n\\n### AI-specific\\nAI agent, LLM, generative AI, conversational AI, RAG, MCP, agent framework, AI form, AI quiz, AI assistant, AI automation\\n\\n### Technical\\nopen source, self-hosted, API-first, webhook, Zapier, no-code, low-code, embeddable, white-label, multi-tenant, SSO, SAML\\n\\n---\\n\\n## Do / Don't Quick Reference\\n\\n**DO:**\\n- Vary the opening sentence across tiers\\n- Use real numbers and specific differentiators\\n- Match tone to audience (technical for devs, business for G2, excited for PH)\\n- Include a founder/origin angle in startup directories\\n- Lead with the AI-first angle in AI directories\\n\\n**DON'T:**\\n- Copy-paste the same 150-word description everywhere\\n- Use vague claims (\\\"blazing fast\\\", \\\"game-changing\\\")\\n- Mention every feature — pick 3–5 per tier and rotate them\\n- Lie about competitor features (AI engines cross-reference and de-rank)\\n- Skip the tag list — it's how moderators route you to the right category\\n\"},\n {\"skill\":\"emails\",\"ref\":\"copy-guidelines\",\"body\":\"# Email Copy Guidelines\\n\\n## Contents\\n- Structure\\n- Formatting\\n- Tone\\n- Length\\n- CTA Buttons vs. Links\\n- Personalization (merge fields, dynamic content, triggered emails)\\n- Segmentation Strategies (by behavior, by stage, by profile)\\n- Testing and Optimization (what to test, how to test, metrics to track)\\n\\n## Structure\\n\\n1. **Hook**: First line grabs attention\\n2. **Context**: Why this matters to them\\n3. **Value**: The useful content\\n4. **CTA**: What to do next\\n5. **Sign-off**: Human, warm close\\n\\n## Formatting\\n\\n- Short paragraphs (1-3 sentences)\\n- White space between sections\\n- Bullet points for scanability\\n- Bold for emphasis (sparingly)\\n- Mobile-first (most read on phone)\\n\\n## Tone\\n\\n- Conversational, not formal\\n- First-person (I/we) and second-person (you)\\n- Active voice\\n- Match your brand but lean friendly\\n- Read it out loud—does it sound human?\\n\\n## Length\\n\\n- Shorter is usually better\\n- 50-125 words for transactional\\n- 150-300 words for educational\\n- 300-500 words for story-driven\\n- If it's long, it better be good\\n\\n## CTA Buttons vs. Links\\n\\n- Buttons: Primary actions, high-visibility\\n- Links: Secondary actions, in-text\\n- One clear primary CTA per email\\n- Button text: Action + outcome\\n\\n---\\n\\n## Personalization\\n\\n### Merge Fields\\n- First name (fallback to \\\"there\\\" or \\\"friend\\\")\\n- Company name (B2B)\\n- Relevant data (usage, plan, etc.)\\n\\n### Dynamic Content\\n- Based on segment\\n- Based on behavior\\n- Based on stage\\n\\n### Triggered Emails\\n- Action-based sends\\n- More relevant than time-based\\n- Examples: Feature used, milestone hit, inactivity\\n\\n---\\n\\n## Segmentation Strategies\\n\\n### By Behavior\\n- Openers vs. non-openers\\n- Clickers vs. non-clickers\\n- Active vs. inactive\\n\\n### By Stage\\n- Trial vs. paid\\n- New vs. long-term\\n- Engaged vs. at-risk\\n\\n### By Profile\\n- Industry/role (B2B)\\n- Use case / goal\\n- Company size\\n\\n---\\n\\n## Testing and Optimization\\n\\n### What to Test\\n- Subject lines (highest impact)\\n- Send times\\n- Email length\\n- CTA placement and copy\\n- Personalization level\\n- Sequence timing\\n\\n### How to Test\\n- A/B test one variable at a time\\n- Sufficient sample size\\n- Statistical significance\\n- Document learnings\\n\\n### Metrics to Track\\n- Open rate (benchmark: 20-40%)\\n- Click rate (benchmark: 2-5%)\\n- Unsubscribe rate (keep under 0.5%)\\n- Conversion rate (specific to sequence goal)\\n- Revenue per email (if applicable)\\n\"}\n];\n",[],[463,774,792],"fc10e91e-5d6d-11f1-981a-1607ee4eb77e","ref_5.ts","fc10ea22-5d6d-11f1-981a-1607ee4eb77e",664,["D",1780286238686],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_5: SkillRef[] = [\n {\"skill\":\"content-strategy\",\"ref\":\"headless-cms\",\"body\":\"# Headless CMS Guide\\n\\nReference for choosing, modeling, and implementing a headless CMS for marketing content.\\n\\n## When to Use This Reference\\n\\nUse this when selecting a CMS for a new project, designing content models for marketing sites, setting up editorial workflows, or connecting CMS content to programmatic pages.\\n\\n---\\n\\n## Headless vs Traditional CMS\\n\\nA headless CMS separates content management from presentation. Content is stored in a structured backend and delivered via API to any frontend.\\n\\n### When Headless Makes Sense\\n\\n- Multiple frontends consume the same content (web, mobile, email)\\n- Developers want full control over the frontend stack\\n- Content needs to be reused across channels\\n- You're building with a modern framework (Next.js, Remix, Astro)\\n- Marketing needs structured, reusable content blocks\\n\\n### When Traditional Works Better\\n\\n- Small team with no dedicated developers\\n- Simple blog or brochure site\\n- WYSIWYG editing is a hard requirement\\n- Budget is tight and WordPress/Webflow does the job\\n\\n### Decision Checklist\\n\\n| Factor | Headless | Traditional |\\n|--------|----------|-------------|\\n| Multi-channel delivery | Yes | Limited |\\n| Developer control | Full | Constrained |\\n| Non-technical editing | Requires setup | Built-in |\\n| Time to launch | Longer | Faster |\\n| Content reuse | Native | Manual |\\n| Hosting flexibility | Any frontend | Platform-dependent |\\n\\n---\\n\\n## Content Modeling for Marketing\\n\\n### Core Principles\\n\\n1. **Think in types, not pages.** A \\\"Landing Page\\\" is a content type with fields — not an HTML file. This lets you reuse components across pages.\\n2. **Separate content from presentation.** Store the headline text, not the styled headline. Presentation belongs in the frontend.\\n3. **Design for reuse.** If testimonials appear on 5 pages, create a Testimonial type and reference it — don't duplicate.\\n4. **Keep models flat.** Deeply nested structures are hard to query and maintain. Prefer references over nesting.\\n\\n### Common Marketing Content Types\\n\\n| Type | Key Fields | Notes |\\n|------|-----------|-------|\\n| **Landing Page** | title, slug, hero, sections[], seo | Modular sections for flexibility |\\n| **Blog Post** | title, slug, body, author, category, tags, publishedAt, seo | Rich text or Portable Text body |\\n| **Case Study** | title, customer, challenge, solution, results, metrics[], logo | Link to related products/features |\\n| **Testimonial** | quote, author, role, company, avatar, rating | Reference from landing pages |\\n| **FAQ** | question, answer, category | Group by category for programmatic pages |\\n| **Author** | name, bio, avatar, social links | Reference from blog posts |\\n| **CTA Block** | heading, body, buttonText, buttonUrl, variant | Reusable across pages |\\n\\n### SEO Fields Checklist\\n\\nEvery page-level content type needs:\\n\\n- `metaTitle` — 50-60 characters\\n- `metaDescription` — 150-160 characters\\n- `ogImage` — 1200x630px social preview\\n- `slug` — URL path segment\\n- `canonicalUrl` — optional override\\n- `noIndex` — boolean for excluding from search\\n- `structuredData` — optional JSON-LD override\\n\\n---\\n\\n## Editorial Workflows\\n\\n### Draft → Review → Publish Cycle\\n\\n1. **Draft** — Author creates or edits content\\n2. **Review** — Editor reviews for accuracy, brand voice, SEO\\n3. **Approve** — Stakeholder signs off\\n4. **Schedule** — Set publish date/time\\n5. **Publish** — Content goes live via API\\n\\n### Preview APIs\\n\\nAll major headless CMS platforms support draft previews:\\n\\n- **Sanity**: Real-time preview with `useLiveQuery` or Presentation tool\\n- **Contentful**: Preview API (`preview.contentful.com`) with separate access token\\n- **Strapi**: Draft & Publish system with `status=draft` query parameter (v5; replaces v4's `publicationState`)\\n\\nSet up a preview route in your frontend (e.g., `/api/preview`) that authenticates and renders draft content.\\n\\n### Roles and Permissions\\n\\n| Role | Can Create | Can Edit | Can Publish | Can Delete |\\n|------|:----------:|:--------:|:-----------:|:----------:|\\n| Author | Yes | Own | No | Own drafts |\\n| Editor | Yes | All | Yes | Drafts |\\n| Admin | Yes | All | Yes | All |\\n\\nExact permission models vary by platform. Sanity uses role-based access. Contentful has space-level roles. Strapi has granular RBAC.\\n\\n---\\n\\n## Platform Comparison\\n\\n| Feature | Sanity | Contentful | Strapi |\\n|---------|--------|------------|--------|\\n| Hosting | Cloud (managed) | Cloud (managed) | Self-hosted or Cloud |\\n| Query Language | GROQ | REST / GraphQL | REST / GraphQL |\\n| Free Tier | Generous | Limited | Open source (free) |\\n| Real-time Collab | Yes (built-in) | Limited | No |\\n| Best For | Developer flexibility | Enterprise multi-locale | Budget / self-hosted |\\n| Content Modeling | Schema-as-code | Web UI | Web UI or code |\\n| Media Handling | Built-in DAM | Built-in | Plugin-based |\\n\\n### Sanity\\n\\n**Strengths**: GROQ query language is powerful and flexible. Schema defined in code (version-controlled). Real-time collaborative editing. Portable Text for rich content. Generous free tier.\\n\\n**Considerations**: Steeper learning curve for non-developers. Studio customization requires React knowledge. Vendor lock-in on GROQ queries.\\n\\n**Marketing fit**: Best when developers and marketers collaborate closely. Strong for content-heavy sites with complex models.\\n\\n### Contentful\\n\\n**Strengths**: Mature enterprise platform. Excellent multi-locale support. Strong ecosystem of integrations. Composable content with Studio. Well-documented APIs.\\n\\n**Considerations**: Pricing scales with content types and locales. Two separate APIs (Delivery and Management). Rate limits can be tight on lower plans.\\n\\n**Marketing fit**: Best for enterprises with multi-market content needs. Good when you need established vendor reliability.\\n\\n### Strapi\\n\\n**Strengths**: Open source, self-hosted option. Full control over data. No per-seat pricing. Customizable admin panel. Plugin ecosystem. REST by default, GraphQL via plugin.\\n\\n**Considerations**: Self-hosting means you handle infrastructure. Smaller ecosystem than Sanity/Contentful. V5 migration can be significant from V4.\\n\\n**Marketing fit**: Best for teams with DevOps capability who want full control and no vendor lock-in. Good for budget-conscious projects.\\n\\n### Others Worth Knowing\\n\\n- **Hygraph** — GraphQL-native, strong for federation and multi-source content\\n- **Keystatic** — Git-based, good for developer-content hybrid workflows\\n- **Payload** — TypeScript-first, self-hosted, code-configured like Sanity\\n- **Builder.io** — Visual editor with headless backend, good for non-technical marketers\\n- **Prismic** — Slice-based content modeling, strong Next.js integration\\n\\n---\\n\\n## Integration with Marketing Skills\\n\\n### Programmatic SEO\\n\\nUse CMS as the data source for programmatic pages. Store structured data (FAQs, comparisons, city pages) as content types and generate pages from queries. See **programmatic-seo** skill.\\n\\n### Copywriting\\n\\nCMS content models enforce consistent structure. Define fields that match your copy frameworks (headline, subheadline, social proof, CTA). See **copywriting** skill.\\n\\n### Site Architecture\\n\\nURL structure, navigation hierarchy, and internal linking all depend on how content is organized in the CMS. Plan your content model and site architecture together. See **site-architecture** skill.\\n\\n### Email Sequences\\n\\nPull CMS content into email templates for consistent messaging across web and email. Case studies, testimonials, and blog posts can feed email nurture sequences. See **emails** skill.\\n\\n---\\n\\n## Implementation Checklist\\n\\n- [ ] Define content types based on page types and reusable blocks\\n- [ ] Add SEO fields to every page-level content type\\n- [ ] Set up preview/draft mode in your frontend\\n- [ ] Configure roles and permissions for your team\\n- [ ] Create sample content for each type before building frontend\\n- [ ] Set up webhook notifications for content changes (rebuild triggers)\\n- [ ] Document content guidelines for editors (field descriptions, character limits)\\n- [ ] Test content delivery performance (CDN, caching, ISR)\\n- [ ] Plan migration strategy if moving from existing CMS\\n\\n---\\n\\n## Relevant Integration Guides\\n\\n- [Sanity](../../../tools/integrations/sanity.md) — GROQ queries, mutations, CLI\\n- [Contentful](../../../tools/integrations/contentful.md) — Delivery/Management APIs, publishing\\n- [Strapi](../../../tools/integrations/strapi.md) — REST CRUD, filters, document API\\n\"},\n {\"skill\":\"copy-editing\",\"ref\":\"checklist\",\"body\":\"# Copy Editing Checklist\\n\\nUse this checklist alongside the Seven Sweeps Framework (see SKILL.md) as a final QA pass before delivering edited copy.\\n\\n## Before You Start\\n\\n- [ ] Understand the goal of this copy\\n- [ ] Know the target audience\\n- [ ] Identify the desired action\\n- [ ] Read through once without editing\\n\\n## Clarity (Sweep 1)\\n\\n- [ ] Every sentence is immediately understandable\\n- [ ] No jargon without explanation\\n- [ ] Pronouns have clear references\\n- [ ] No sentences trying to do too much\\n\\n## Voice & Tone (Sweep 2)\\n\\n- [ ] Consistent formality level throughout\\n- [ ] Brand personality maintained\\n- [ ] No jarring shifts in mood\\n- [ ] Reads well aloud\\n\\n## So What (Sweep 3)\\n\\n- [ ] Every feature connects to a benefit\\n- [ ] Claims answer \\\"why should I care?\\\"\\n- [ ] Benefits connect to real desires\\n- [ ] No impressive-but-empty statements\\n\\n## Prove It (Sweep 4)\\n\\n- [ ] Claims are substantiated\\n- [ ] Social proof is specific and attributed\\n- [ ] Numbers and stats have sources\\n- [ ] No unearned superlatives\\n\\n## Specificity (Sweep 5)\\n\\n- [ ] Vague words replaced with concrete ones\\n- [ ] Numbers and timeframes included\\n- [ ] Generic statements made specific\\n- [ ] Filler content removed\\n\\n## Heightened Emotion (Sweep 6)\\n\\n- [ ] Copy evokes feeling, not just information\\n- [ ] Pain points feel real\\n- [ ] Aspirations feel achievable\\n- [ ] Emotion serves the message authentically\\n\\n## Zero Risk (Sweep 7)\\n\\n- [ ] Objections addressed near CTA\\n- [ ] Trust signals present\\n- [ ] Next steps are crystal clear\\n- [ ] Risk reversals stated (guarantee, trial, etc.)\\n\\n## Final Checks\\n\\n- [ ] No typos or grammatical errors\\n- [ ] Consistent formatting\\n- [ ] Links work (if applicable)\\n- [ ] Core message preserved through all edits\\n\"},\n {\"skill\":\"copy-editing\",\"ref\":\"content-refresh\",\"body\":\"# Content Refresh Editing\\n\\nCopy editing isn't just for new content. Existing pages and posts decay over time — outdated stats, stale examples, drifted brand voice, and missed SEO opportunities. A content refresh applies the same editing rigor to content that's already published.\\n\\n## When to Refresh\\n\\n- **Traffic declining** on a page that used to perform well\\n- **Stats or data** are more than 12 months old\\n- **Product has changed** — features, pricing, or positioning no longer match\\n- **Competitors updated** their version of the same content\\n- **AI search visibility** matters — outdated content gets cited less (see ai-seo skill)\\n\\n## Content Refresh Checklist\\n\\n1. **Freshness pass** — Update all dates, stats, and examples. Replace \\\"in 2024\\\" with current data. Remove references to deprecated features or tools.\\n2. **Accuracy pass** — Verify all claims are still true. Check that linked resources still exist. Confirm pricing and feature descriptions match current state.\\n3. **Voice pass** — Does the tone match your current brand voice? Older content often reflects an earlier stage of the company.\\n4. **SEO pass** — Has search intent shifted for this topic? Are there new keywords or questions to address? Add \\\"Last updated: [date]\\\" prominently.\\n5. **Proof pass** — Can you add newer testimonials, case studies, or data points that didn't exist when this was first published?\\n6. **Structure pass** — Add comparison tables, FAQ sections, or other scannable formats that make the content easier to consume.\\n\\n## Refresh vs. Rewrite\\n\\n| Signal | Action |\\n|--------|--------|\\n| Core message still valid, details outdated | Refresh (update facts, stats, examples) |\\n| Brand voice has evolved significantly | Refresh + voice rewrite |\\n| Topic angle or audience has shifted | Full rewrite |\\n| Page structure doesn't match current search intent | Full rewrite |\\n| Just needs updated stats and links | Light refresh |\\n\\n## Refresh Cadence\\n\\n- **Pricing and product pages**: Every quarter, or when pricing/features change\\n- **High-traffic blog posts**: Every 6 months\\n- **Comparison and alternatives pages**: Every 3-6 months (competitors change fast)\\n- **Evergreen guides**: Annually, unless traffic drops sooner\\n- **Low-traffic pages**: Only when traffic data suggests an opportunity\\n\"},\n {\"skill\":\"copy-editing\",\"ref\":\"plain-english-alternatives\",\"body\":\"# Plain English Alternatives\\n\\nReplace complex or pompous words with plain English alternatives.\\n\\nSource: Plain English Campaign A-Z of Alternative Words (2001), Australian Government Style Manual (2024), plainlanguage.gov\\n\\n---\\n\\n## Contents\\n- A\\n- B\\n- C\\n- D\\n- E\\n- F\\n- G-H\\n- I\\n- L-M\\n- N-O\\n- P\\n- R\\n- S\\n- T-U\\n- V-Z\\n- Phrases to Remove Entirely\\n\\n## A\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| (an) absence of | no, none |\\n| abundance | enough, plenty, many |\\n| accede to | allow, agree to |\\n| accelerate | speed up |\\n| accommodate | meet, hold, house |\\n| accomplish | do, finish, complete |\\n| accordingly | so, therefore |\\n| acknowledge | thank you for, confirm |\\n| acquire | get, buy, obtain |\\n| additional | extra, more |\\n| adjacent | next to |\\n| advantageous | useful, helpful |\\n| advise | tell, say, inform |\\n| aforesaid | this, earlier |\\n| aggregate | total |\\n| alleviate | ease, reduce |\\n| allocate | give, share, assign |\\n| alternative | other, choice |\\n| ameliorate | improve |\\n| anticipate | expect |\\n| apparent | clear, obvious |\\n| appreciable | large, noticeable |\\n| appropriate | proper, right, suitable |\\n| approximately | about, roughly |\\n| ascertain | find out |\\n| assistance | help |\\n| at the present time | now |\\n| attempt | try |\\n| authorise | allow, let |\\n\\n---\\n\\n## B\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| belated | late |\\n| beneficial | helpful, useful |\\n| bestow | give |\\n| by means of | by |\\n\\n---\\n\\n## C\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| calculate | work out |\\n| cease | stop, end |\\n| circumvent | avoid, get around |\\n| clarification | explanation |\\n| commence | start, begin |\\n| communicate | tell, talk, write |\\n| competent | able |\\n| compile | collect, make |\\n| complete | fill in, finish |\\n| component | part |\\n| comprise | include, make up |\\n| (it is) compulsory | (you) must |\\n| conceal | hide |\\n| concerning | about |\\n| consequently | so |\\n| considerable | large, great, much |\\n| constitute | make up, form |\\n| consult | ask, talk to |\\n| consumption | use |\\n| currently | now |\\n\\n---\\n\\n## D\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| deduct | take off |\\n| deem | treat as, consider |\\n| defer | delay, put off |\\n| deficiency | lack |\\n| delete | remove, cross out |\\n| demonstrate | show, prove |\\n| denote | show, mean |\\n| designate | name, appoint |\\n| despatch/dispatch | send |\\n| determine | decide, find out |\\n| detrimental | harmful |\\n| diminish | reduce, lessen |\\n| discontinue | stop |\\n| disseminate | spread, distribute |\\n| documentation | papers, documents |\\n| due to the fact that | because |\\n| duration | time, length |\\n| dwelling | home |\\n\\n---\\n\\n## E\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| economical | cheap, good value |\\n| eligible | allowed, qualified |\\n| elucidate | explain |\\n| enable | allow |\\n| encounter | meet |\\n| endeavour | try |\\n| enquire | ask |\\n| ensure | make sure |\\n| entitlement | right |\\n| envisage | expect |\\n| equivalent | equal, the same |\\n| erroneous | wrong |\\n| establish | set up, show |\\n| evaluate | assess, test |\\n| excessive | too much |\\n| exclusively | only |\\n| exempt | free from |\\n| expedite | speed up |\\n| expenditure | spending |\\n| expire | run out |\\n\\n---\\n\\n## F\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| fabricate | make |\\n| facilitate | help, make possible |\\n| finalise | finish, complete |\\n| following | after |\\n| for the purpose of | to, for |\\n| for the reason that | because |\\n| forthwith | now, at once |\\n| forward | send |\\n| frequently | often |\\n| furnish | give, provide |\\n| furthermore | also, and |\\n\\n---\\n\\n## G-H\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| generate | produce, create |\\n| henceforth | from now on |\\n| hitherto | until now |\\n\\n---\\n\\n## I\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| if and when | if, when |\\n| illustrate | show |\\n| immediately | at once, now |\\n| implement | carry out, do |\\n| imply | suggest |\\n| in accordance with | under, following |\\n| in addition to | and, also |\\n| in conjunction with | with |\\n| in excess of | more than |\\n| in lieu of | instead of |\\n| in order to | to |\\n| in receipt of | receive |\\n| in relation to | about |\\n| in respect of | about, for |\\n| in the event of | if |\\n| in the majority of instances | most, usually |\\n| in the near future | soon |\\n| in view of the fact that | because |\\n| inception | start |\\n| indicate | show, suggest |\\n| inform | tell |\\n| initiate | start, begin |\\n| insert | put in |\\n| instances | cases |\\n| irrespective of | despite |\\n| issue | give, send |\\n\\n---\\n\\n## L-M\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| (a) large number of | many |\\n| liaise with | work with, talk to |\\n| locality | place, area |\\n| locate | find |\\n| magnitude | size |\\n| (it is) mandatory | (you) must |\\n| manner | way |\\n| modification | change |\\n| moreover | also, and |\\n\\n---\\n\\n## N-O\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| negligible | small |\\n| nevertheless | but, however |\\n| notify | tell |\\n| notwithstanding | despite, even if |\\n| numerous | many |\\n| objective | aim, goal |\\n| (it is) obligatory | (you) must |\\n| obtain | get |\\n| occasioned by | caused by |\\n| on behalf of | for |\\n| on numerous occasions | often |\\n| on receipt of | when you get |\\n| on the grounds that | because |\\n| operate | work, run |\\n| optimum | best |\\n| option | choice |\\n| otherwise | or |\\n| outstanding | unpaid |\\n| owing to | because |\\n\\n---\\n\\n## P\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| partially | partly |\\n| participate | take part |\\n| particulars | details |\\n| per annum | a year |\\n| perform | do |\\n| permit | let, allow |\\n| personnel | staff, people |\\n| peruse | read |\\n| possess | have, own |\\n| practically | almost |\\n| predominant | main |\\n| prescribe | set |\\n| preserve | keep |\\n| previous | earlier, before |\\n| principal | main |\\n| prior to | before |\\n| proceed | go ahead |\\n| procure | get |\\n| prohibit | ban, stop |\\n| promptly | quickly |\\n| provide | give |\\n| provided that | if |\\n| provisions | rules, terms |\\n| proximity | nearness |\\n| purchase | buy |\\n| pursuant to | under |\\n\\n---\\n\\n## R\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| reconsider | think again |\\n| reduction | cut |\\n| referred to as | called |\\n| regarding | about |\\n| reimburse | repay |\\n| reiterate | repeat |\\n| relating to | about |\\n| remain | stay |\\n| remainder | rest |\\n| remuneration | pay |\\n| render | make, give |\\n| represent | stand for |\\n| request | ask |\\n| require | need |\\n| residence | home |\\n| retain | keep |\\n| revised | changed, new |\\n\\n---\\n\\n## S\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| scrutinise | examine, check |\\n| select | choose |\\n| solely | only |\\n| specified | given, stated |\\n| state | say |\\n| statutory | legal, by law |\\n| subject to | depending on |\\n| submit | send, give |\\n| subsequent to | after |\\n| subsequently | later |\\n| substantial | large, much |\\n| sufficient | enough |\\n| supplement | add to |\\n| supplementary | extra |\\n\\n---\\n\\n## T-U\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| terminate | end, stop |\\n| thereafter | then |\\n| thereby | by this |\\n| thus | so |\\n| to date | so far |\\n| transfer | move |\\n| transmit | send |\\n| ultimately | in the end |\\n| undertake | agree, do |\\n| uniform | same |\\n| utilise | use |\\n\\n---\\n\\n## V-Z\\n\\n| Complex | Plain Alternative |\\n|---------|-------------------|\\n| variation | change |\\n| virtually | almost |\\n| visualise | imagine, see |\\n| ways and means | ways |\\n| whatsoever | any |\\n| with a view to | to |\\n| with effect from | from |\\n| with reference to | about |\\n| with regard to | about |\\n| with respect to | about |\\n| zone | area |\\n\\n---\\n\\n## Phrases to Remove Entirely\\n\\nThese phrases often add nothing. Delete them:\\n\\n- a total of\\n- absolutely\\n- actually\\n- all things being equal\\n- as a matter of fact\\n- at the end of the day\\n- at this moment in time\\n- basically\\n- currently (when \\\"now\\\" or nothing works)\\n- I am of the opinion that (use: I think)\\n- in due course (use: soon, or say when)\\n- in the final analysis\\n- it should be understood\\n- last but not least\\n- obviously\\n- of course\\n- quite\\n- really\\n- the fact of the matter is\\n- to all intents and purposes\\n- very\\n\"},\n {\"skill\":\"copywriting\",\"ref\":\"copy-frameworks\",\"body\":\"# Copy Frameworks Reference\\n\\nHeadline formulas, page section types, and structural templates.\\n\\n## Contents\\n- Headline Formulas (outcome-focused, problem-focused, audience-focused, differentiation-focused, proof-focused, additional formulas)\\n- Landing Page Section Types (core sections, supporting sections)\\n- Page Structure Templates (feature-heavy page, varied engaging page, compact landing page, enterprise/B2B landing page, product launch page)\\n- Section Writing Tips (problem section, benefits section, how it works section, testimonial selection)\\n\\n## Headline Formulas\\n\\n### Outcome-Focused\\n\\n**{Achieve desirable outcome} without {pain point}**\\n> Understand how users are really experiencing your site without drowning in numbers\\n\\n**{Achieve desirable outcome} by {how product makes it possible}**\\n> Generate more leads by seeing which companies visit your site\\n\\n**Turn {input} into {outcome}**\\n> Turn your hard-earned sales into repeat customers\\n\\n**[Achieve outcome] in [timeframe]**\\n> Get your tax refund in 10 days\\n\\n---\\n\\n### Problem-Focused\\n\\n**Never {unpleasant event} again**\\n> Never miss a sales opportunity again\\n\\n**{Question highlighting the main pain point}**\\n> Hate returning stuff to Amazon?\\n\\n**Stop [pain]. Start [pleasure].**\\n> Stop chasing invoices. Start getting paid on time.\\n\\n---\\n\\n### Audience-Focused\\n\\n**{Key feature/product type} for {target audience}**\\n> Advanced analytics for Shopify e-commerce\\n\\n**{Key feature/product type} for {target audience} to {what it's used for}**\\n> An online whiteboard for teams to ideate and brainstorm together\\n\\n**You don't have to {skills or resources} to {achieve desirable outcome}**\\n> With Ahrefs, you don't have to be an SEO pro to rank higher and get more traffic\\n\\n---\\n\\n### Differentiation-Focused\\n\\n**The {opposite of usual process} way to {achieve desirable outcome}**\\n> The easiest way to turn your passion into income\\n\\n**The [category] that [key differentiator]**\\n> The CRM that updates itself\\n\\n---\\n\\n### Proof-Focused\\n\\n**[Number] [people] use [product] to [outcome]**\\n> 50,000 marketers use Drip to send better emails\\n\\n**{Key benefit of your product}**\\n> Sound clear in online meetings\\n\\n---\\n\\n### Additional Formulas\\n\\n**The simple way to {outcome}**\\n> The simple way to track your time\\n\\n**Finally, {category} that {benefit}**\\n> Finally, accounting software that doesn't suck\\n\\n**{Outcome} without {common pain}**\\n> Build your website without writing code\\n\\n**Get {benefit} from your {thing}**\\n> Get more revenue from your existing traffic\\n\\n**{Action verb} your {thing} like {admirable example}**\\n> Market your SaaS like a Fortune 500\\n\\n**What if you could {desirable outcome}?**\\n> What if you could close deals 30% faster?\\n\\n**Everything you need to {outcome}**\\n> Everything you need to launch your course\\n\\n**The {adjective} {category} built for {audience}**\\n> The lightweight CRM built for startups\\n\\n---\\n\\n## Landing Page Section Types\\n\\n### Core Sections\\n\\n**Hero (Above the Fold)**\\n- Headline + subheadline\\n- Primary CTA\\n- Supporting visual (product screenshot, hero image)\\n- Optional: Social proof bar\\n\\n**Social Proof Bar**\\n- Customer logos (recognizable > many)\\n- Key metric (\\\"10,000+ teams\\\")\\n- Star rating with review count\\n- Short testimonial snippet\\n\\n**Problem/Pain Section**\\n- Articulate their problem better than they can\\n- Create recognition (\\\"that's exactly my situation\\\")\\n- Hint at cost of not solving it\\n\\n**Solution/Benefits Section**\\n- Bridge from problem to your solution\\n- 3-5 key benefits (not 10)\\n- Each: headline + explanation + proof if available\\n\\n**How It Works**\\n- 3-4 numbered steps\\n- Reduces perceived complexity\\n- Each step: action + outcome\\n\\n**Final CTA Section**\\n- Recap value proposition\\n- Repeat primary CTA\\n- Risk reversal (guarantee, free trial)\\n\\n---\\n\\n### Supporting Sections\\n\\n**Testimonials**\\n- Full quotes with names, roles, companies\\n- Photos when possible\\n- Specific results over vague praise\\n- Formats: quote cards, video, tweet embeds\\n\\n**Case Studies**\\n- Problem → Solution → Results\\n- Specific metrics and outcomes\\n- Customer name and context\\n- Can be snippets with \\\"Read more\\\" links\\n\\n**Use Cases**\\n- Different ways product is used\\n- Helps visitors self-identify\\n- \\\"For marketers who need X\\\" format\\n\\n**Personas / \\\"Built For\\\" Sections**\\n- Explicitly call out target audience\\n- \\\"Perfect for [role]\\\" blocks\\n- Addresses \\\"Is this for me?\\\" question\\n\\n**FAQ Section**\\n- Address common objections\\n- Good for SEO\\n- Reduces support burden\\n- 5-10 most common questions\\n\\n**Comparison Section**\\n- vs. competitors (name them or don't)\\n- vs. status quo (spreadsheets, manual processes)\\n- Tables or side-by-side format\\n\\n**Integrations / Partners**\\n- Logos of tools you connect with\\n- \\\"Works with your stack\\\" messaging\\n- Builds credibility\\n\\n**Founder Story / Manifesto**\\n- Why you built this\\n- What you believe\\n- Emotional connection\\n- Differentiates from faceless competitors\\n\\n**Demo / Product Tour**\\n- Interactive demos\\n- Video walkthroughs\\n- GIF previews\\n- Shows product in action\\n\\n**Pricing Preview**\\n- Teaser even on non-pricing pages\\n- Starting price or \\\"from $X/mo\\\"\\n- Moves decision-makers forward\\n\\n**Guarantee / Risk Reversal**\\n- Money-back guarantee\\n- Free trial terms\\n- \\\"Cancel anytime\\\"\\n- Reduces friction\\n\\n**Stats Section**\\n- Key metrics that build credibility\\n- \\\"10,000+ customers\\\"\\n- \\\"4.9/5 rating\\\"\\n- \\\"$2M saved for customers\\\"\\n\\n---\\n\\n## Page Structure Templates\\n\\n### Feature-Heavy Page (Weak)\\n\\n```\\n1. Hero\\n2. Feature 1\\n3. Feature 2\\n4. Feature 3\\n5. Feature 4\\n6. CTA\\n```\\n\\nThis is a list, not a persuasive narrative.\\n\\n---\\n\\n### Varied, Engaging Page (Strong)\\n\\n```\\n1. Hero with clear value prop\\n2. Social proof bar (logos or stats)\\n3. Problem/pain section\\n4. How it works (3 steps)\\n5. Key benefits (2-3, not 10)\\n6. Testimonial\\n7. Use cases or personas\\n8. Comparison to alternatives\\n9. Case study snippet\\n10. FAQ\\n11. Final CTA with guarantee\\n```\\n\\nThis tells a story and addresses objections.\\n\\n---\\n\\n### Compact Landing Page\\n\\n```\\n1. Hero (headline, subhead, CTA, image)\\n2. Social proof bar\\n3. 3 key benefits with icons\\n4. Testimonial\\n5. How it works (3 steps)\\n6. Final CTA with guarantee\\n```\\n\\nGood for ad landing pages where brevity matters.\\n\\n---\\n\\n### Enterprise/B2B Landing Page\\n\\n```\\n1. Hero (outcome-focused headline)\\n2. Logo bar (recognizable companies)\\n3. Problem section (business pain)\\n4. Solution overview\\n5. Use cases by role/department\\n6. Security/compliance section\\n7. Integration logos\\n8. Case study with metrics\\n9. ROI/value section\\n10. Contact/demo CTA\\n```\\n\\nAddresses enterprise buyer concerns.\\n\\n---\\n\\n### Product Launch Page\\n\\n```\\n1. Hero with launch announcement\\n2. Video demo or walkthrough\\n3. Feature highlights (3-5)\\n4. Before/after comparison\\n5. Early testimonials\\n6. Launch pricing or early access offer\\n7. CTA with urgency\\n```\\n\\nGood for ProductHunt, launches, or announcements.\\n\\n---\\n\\n## Section Writing Tips\\n\\n### Problem Section\\n\\nStart with phrases like:\\n- \\\"You know the feeling...\\\"\\n- \\\"If you're like most [role]...\\\"\\n- \\\"Every day, [audience] struggles with...\\\"\\n- \\\"We've all been there...\\\"\\n\\nThen describe:\\n- The specific frustration\\n- The time/money wasted\\n- The impact on their work/life\\n\\n### Benefits Section\\n\\nFor each benefit, include:\\n- **Headline**: The outcome they get\\n- **Body**: How it works (1-2 sentences)\\n- **Proof**: Number, testimonial, or example (optional)\\n\\n### How It Works Section\\n\\nEach step should be:\\n- **Numbered**: Creates sense of progress\\n- **Simple verb**: \\\"Connect,\\\" \\\"Set up,\\\" \\\"Get\\\"\\n- **Outcome-oriented**: What they get from this step\\n\\nExample:\\n1. Connect your tools (takes 2 minutes)\\n2. Set your preferences\\n3. Get automated reports every Monday\\n\\n### Testimonial Selection\\n\\nBest testimonials include:\\n- Specific results (\\\"increased conversions by 32%\\\")\\n- Before/after context (\\\"We used to spend hours...\\\")\\n- Role + company for credibility\\n- Something quotable and specific\\n\\nAvoid testimonials that just say:\\n- \\\"Great product!\\\"\\n- \\\"Love it!\\\"\\n- \\\"Easy to use!\\\"\\n\"},\n {\"skill\":\"copywriting\",\"ref\":\"natural-transitions\",\"body\":\"# Natural Transitions\\n\\nTransitional phrases to guide readers through your content. Good signposting improves readability, user engagement, and helps search engines understand content structure.\\n\\nAdapted from: University of Manchester Academic Phrasebank (2023), Plain English Campaign, web content best practices\\n\\n---\\n\\n## Contents\\n- Previewing Content Structure\\n- Introducing a New Topic\\n- Referring Back\\n- Moving Between Sections\\n- Indicating Addition\\n- Indicating Contrast\\n- Indicating Similarity\\n- Indicating Cause and Effect\\n- Giving Examples\\n- Emphasising Key Points\\n- Providing Evidence (neutral attribution, expert quotes, supporting claims)\\n- Summarising Sections\\n- Concluding Content\\n- Question-Based Transitions\\n- List Introductions\\n- Hedging Language\\n- Best Practice Guidelines\\n- Transitions to Avoid (AI Tells)\\n\\n## Previewing Content Structure\\n\\nUse to orient readers and set expectations:\\n\\n- Here's what we'll cover...\\n- This guide walks you through...\\n- Below, you'll find...\\n- We'll start with X, then move to Y...\\n- First, let's look at...\\n- Let's break this down step by step.\\n- The sections below explain...\\n\\n---\\n\\n## Introducing a New Topic\\n\\n- When it comes to X,...\\n- Regarding X,...\\n- Speaking of X,...\\n- Now let's talk about X.\\n- Another key factor is...\\n- X is worth exploring because...\\n\\n---\\n\\n## Referring Back\\n\\nUse to connect ideas and reinforce key points:\\n\\n- As mentioned earlier,...\\n- As we covered above,...\\n- Remember when we discussed X?\\n- Building on that point,...\\n- Going back to X,...\\n- Earlier, we explained that...\\n\\n---\\n\\n## Moving Between Sections\\n\\n- Now let's look at...\\n- Next up:...\\n- Moving on to...\\n- With that covered, let's turn to...\\n- Now that you understand X, here's Y.\\n- That brings us to...\\n\\n---\\n\\n## Indicating Addition\\n\\n- Also,...\\n- Plus,...\\n- On top of that,...\\n- What's more,...\\n- Another benefit is...\\n- Beyond that,...\\n- In addition,...\\n- There's also...\\n\\n**Note:** Use \\\"moreover\\\" and \\\"furthermore\\\" sparingly. They can sound AI-generated when overused.\\n\\n---\\n\\n## Indicating Contrast\\n\\n- However,...\\n- But,...\\n- That said,...\\n- On the flip side,...\\n- In contrast,...\\n- Unlike X, Y...\\n- While X is true, Y...\\n- Despite this,...\\n\\n---\\n\\n## Indicating Similarity\\n\\n- Similarly,...\\n- Likewise,...\\n- In the same way,...\\n- Just like X, Y also...\\n- This mirrors...\\n- The same applies to...\\n\\n---\\n\\n## Indicating Cause and Effect\\n\\n- So,...\\n- This means...\\n- As a result,...\\n- That's why...\\n- Because of this,...\\n- This leads to...\\n- The outcome?...\\n- Here's what happens:...\\n\\n---\\n\\n## Giving Examples\\n\\n- For example,...\\n- For instance,...\\n- Here's an example:...\\n- Take X, for instance.\\n- Consider this:...\\n- A good example is...\\n- To illustrate,...\\n- Like when...\\n- Say you want to...\\n\\n---\\n\\n## Emphasising Key Points\\n\\n- Here's the key takeaway:...\\n- The important thing is...\\n- What matters most is...\\n- Don't miss this:...\\n- Pay attention to...\\n- This is critical:...\\n- The bottom line?...\\n\\n---\\n\\n## Providing Evidence\\n\\nUse when citing sources, data, or expert opinions:\\n\\n### Neutral attribution\\n- According to [Source],...\\n- [Source] reports that...\\n- Research shows that...\\n- Data from [Source] indicates...\\n- A study by [Source] found...\\n\\n### Expert quotes\\n- As [Expert] puts it,...\\n- [Expert] explains,...\\n- In the words of [Expert],...\\n- [Expert] notes that...\\n\\n### Supporting claims\\n- This is backed by...\\n- Evidence suggests...\\n- The numbers confirm...\\n- This aligns with findings from...\\n\\n---\\n\\n## Summarising Sections\\n\\n- To recap,...\\n- Here's the short version:...\\n- In short,...\\n- The takeaway?...\\n- So what does this mean?...\\n- Let's pull this together:...\\n- Quick summary:...\\n\\n---\\n\\n## Concluding Content\\n\\n- Wrapping up,...\\n- The bottom line is...\\n- Here's what to do next:...\\n- To sum up,...\\n- Final thoughts:...\\n- Ready to get started?...\\n- Now it's your turn.\\n\\n**Note:** Avoid \\\"In conclusion\\\" at the start of a paragraph. It's overused and signals AI writing.\\n\\n---\\n\\n## Question-Based Transitions\\n\\nUseful for conversational tone and featured snippet optimization:\\n\\n- So what does this mean for you?\\n- But why does this matter?\\n- How do you actually do this?\\n- What's the catch?\\n- Sound complicated? It's not.\\n- Wondering where to start?\\n- Still not sure? Here's the breakdown.\\n\\n---\\n\\n## List Introductions\\n\\nFor numbered lists and step-by-step content:\\n\\n- Here's how to do it:\\n- Follow these steps:\\n- The process is straightforward:\\n- Here's what you need to know:\\n- Key things to consider:\\n- The main factors are:\\n\\n---\\n\\n## Hedging Language\\n\\nFor claims that need qualification or aren't absolute:\\n\\n- may, might, could\\n- tends to, generally\\n- often, usually, typically\\n- in most cases\\n- it appears that\\n- evidence suggests\\n- this can help\\n- many experts believe\\n\\n---\\n\\n## Best Practice Guidelines\\n\\n1. **Match tone to audience**: B2B content can be slightly more formal; B2C often benefits from conversational transitions\\n2. **Vary your transitions**: Repeating the same phrase gets noticed (and not in a good way)\\n3. **Don't over-signpost**: Trust your reader; every sentence doesn't need a transition\\n4. **Use for scannability**: Transitions at paragraph starts help skimmers navigate\\n5. **Keep it natural**: Read aloud; if it sounds forced, simplify\\n6. **Front-load key info**: Put the important word or phrase early in the transition\\n\\n---\\n\\n## Transitions to Avoid (AI Tells)\\n\\nThese phrases are overused in AI-generated content:\\n\\n- \\\"That being said,...\\\"\\n- \\\"It's worth noting that...\\\"\\n- \\\"At its core,...\\\"\\n- \\\"In today's digital landscape,...\\\"\\n- \\\"When it comes to the realm of...\\\"\\n- \\\"This begs the question...\\\"\\n- \\\"Let's delve into...\\\"\\n\\nSee the seo-audit skill's `references/ai-writing-detection.md` for a complete list of AI writing tells.\\n\"},\n {\"skill\":\"cro\",\"ref\":\"experiments\",\"body\":\"# Page CRO Experiment Ideas\\n\\nComprehensive list of A/B tests and experiments organized by page type.\\n\\n## Contents\\n- Homepage Experiments (Hero Section, Trust & Social Proof, Features & Content, Navigation & UX)\\n- Pricing Page Experiments (Price Presentation, Pricing UX, Objection Handling, Trust Signals)\\n- Demo Request Page Experiments (Form Optimization, Page Content, CTA & Routing)\\n- Resource/Blog Page Experiments (Content CTAs, Resource Section)\\n- Landing Page Experiments (Message Match, Conversion Focus, Page Length)\\n- Feature Page Experiments (Feature Presentation, Conversion Path)\\n- Cross-Page Experiments (Site-Wide Tests, Navigation Tests)\\n\\n## Homepage Experiments\\n\\n### Hero Section\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Headline variations | Specific vs. abstract messaging |\\n| Subheadline clarity | Add/refine to support headline |\\n| CTA above fold | Include or exclude prominent CTA |\\n| Hero visual format | Screenshot vs. GIF vs. illustration vs. video |\\n| CTA button color | Test contrast and visibility |\\n| CTA button text | \\\"Start Free Trial\\\" vs. \\\"Get Started\\\" vs. \\\"See Demo\\\" |\\n| Interactive demo | Engage visitors immediately with product |\\n\\n### Trust & Social Proof\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Logo placement | Hero section vs. below fold |\\n| Case study in hero | Show results immediately |\\n| Trust badges | Add security, compliance, awards |\\n| Social proof in headline | \\\"Join 10,000+ teams\\\" messaging |\\n| Testimonial placement | Above fold vs. dedicated section |\\n| Video testimonials | More engaging than text quotes |\\n\\n### Features & Content\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Feature presentation | Icons + descriptions vs. detailed sections |\\n| Section ordering | Move high-value features up |\\n| Secondary CTAs | Add/remove throughout page |\\n| Benefit vs. feature focus | Lead with outcomes |\\n| Comparison section | Show vs. competitors or status quo |\\n\\n### Navigation & UX\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Sticky navigation | Persistent nav with CTA |\\n| Nav menu order | High-priority items at edges |\\n| Nav CTA button | Add prominent button in nav |\\n| Support widget | Live chat vs. AI chatbot |\\n| Footer optimization | Clearer secondary conversions |\\n| Exit intent popup | Capture abandoning visitors |\\n\\n---\\n\\n## Pricing Page Experiments\\n\\n### Price Presentation\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Annual vs. monthly display | Highlight savings or simplify |\\n| Price points | $99 vs. $100 vs. $97 psychology |\\n| \\\"Most Popular\\\" badge | Highlight target plan |\\n| Number of tiers | 3 vs. 4 vs. 2 visible options |\\n| Price anchoring | Order plans to anchor expectations |\\n| Custom enterprise tier | Show vs. \\\"Contact Sales\\\" |\\n\\n### Pricing UX\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Pricing calculator | For usage-based pricing clarity |\\n| Guided pricing flow | Multistep wizard vs. comparison table |\\n| Feature comparison format | Table vs. expandable sections |\\n| Monthly/annual toggle | With savings highlighted |\\n| Plan recommendation quiz | Help visitors choose |\\n| Checkout flow length | Steps required after plan selection |\\n\\n### Objection Handling\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| FAQ section | Address pricing objections |\\n| ROI calculator | Demonstrate value vs. cost |\\n| Money-back guarantee | Prominent placement |\\n| Per-user breakdowns | Clarity for team plans |\\n| Feature inclusion clarity | What's in each tier |\\n| Competitor comparison | Side-by-side value comparison |\\n\\n### Trust Signals\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Value testimonials | Quotes about ROI specifically |\\n| Customer logos | Near pricing section |\\n| Review scores | G2/Capterra ratings |\\n| Case study snippet | Specific pricing/value results |\\n\\n---\\n\\n## Demo Request Page Experiments\\n\\n### Form Optimization\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Field count | Fewer fields, higher completion |\\n| Multi-step vs. single | Progress bar encouragement |\\n| Form placement | Above fold vs. after content |\\n| Phone field | Include vs. exclude |\\n| Field enrichment | Hide fields you can auto-fill |\\n| Form labels | Inside field vs. above |\\n\\n### Page Content\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Benefits above form | Reinforce value before ask |\\n| Demo preview | Video/GIF showing demo experience |\\n| \\\"What You'll Learn\\\" | Set expectations clearly |\\n| Testimonials near form | Reduce friction at decision point |\\n| FAQ below form | Address common objections |\\n| Video vs. text | Format for explaining value |\\n\\n### CTA & Routing\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| CTA text | \\\"Book Your Demo\\\" vs. \\\"Schedule 15-Min Call\\\" |\\n| On-demand option | Instant demo alongside live option |\\n| Personalized messaging | Based on visitor data/source |\\n| Navigation removal | Reduce page distractions |\\n| Calendar integration | Inline booking vs. external link |\\n| Qualification routing | Self-serve for some, sales for others |\\n\\n---\\n\\n## Resource/Blog Page Experiments\\n\\n### Content CTAs\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Floating CTAs | Sticky CTA on blog posts |\\n| CTA placement | Inline vs. end-of-post only |\\n| Reading time display | Estimated reading time |\\n| Related resources | End-of-article recommendations |\\n| Gated vs. free | Content access strategy |\\n| Content upgrades | Specific to article topic |\\n\\n### Resource Section\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Navigation/filtering | Easier to find relevant content |\\n| Search functionality | Find specific resources |\\n| Featured resources | Highlight best content |\\n| Layout format | Grid vs. list view |\\n| Topic bundles | Grouped resources by theme |\\n| Download tracking | Gate some, track engagement |\\n\\n---\\n\\n## Landing Page Experiments\\n\\n### Message Match\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Headline matching | Match ad copy exactly |\\n| Visual matching | Match ad creative |\\n| Offer alignment | Same offer as ad promised |\\n| Audience-specific pages | Different pages per segment |\\n\\n### Conversion Focus\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Navigation removal | Single-focus page |\\n| CTA repetition | Multiple CTAs throughout |\\n| Form vs. button | Direct capture vs. click-through |\\n| Urgency/scarcity | If genuine, test messaging |\\n| Social proof density | Amount and placement |\\n| Video inclusion | Explain offer with video |\\n\\n### Page Length\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Short vs. long | Quick conversion vs. complete argument |\\n| Above-fold only | Minimal scroll required |\\n| Section ordering | Most important content first |\\n| Footer removal | Eliminate navigation |\\n\\n---\\n\\n## Feature Page Experiments\\n\\n### Feature Presentation\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Demo/screenshot | Show feature in action |\\n| Use case examples | How customers use it |\\n| Before/after | Impact visualization |\\n| Video walkthrough | Feature tour |\\n| Interactive demo | Try feature without signup |\\n\\n### Conversion Path\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Trial CTA | Feature-specific trial offer |\\n| Related features | Cross-link to other features |\\n| Comparison | vs. competitors' version |\\n| Pricing mention | Connect to relevant plan |\\n| Case study link | Feature-specific success story |\\n\\n---\\n\\n## Cross-Page Experiments\\n\\n### Site-Wide Tests\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Chat widget | Impact on conversions |\\n| Cookie consent UX | Minimize friction |\\n| Page load speed | Performance vs. features |\\n| Mobile experience | Responsive optimization |\\n| Accessibility | Impact on conversion |\\n| Personalization | Dynamic content by segment |\\n\\n### Navigation Tests\\n\\n| Test | Hypothesis |\\n|------|------------|\\n| Menu structure | Information architecture |\\n| Search placement | Help visitors find content |\\n| CTA in nav | Always-visible conversion path |\\n| Breadcrumbs | Navigation clarity |\\n\"},\n {\"skill\":\"cro\",\"ref\":\"form\",\"body\":\"# Form CRO\\n\\nYou are an expert in form optimization. Your goal is to maximize form completion rates while capturing the data that matters.\\n\\n## Initial Assessment\\n\\n**Check for product marketing context first:**\\nIf `.agents/product-marketing.md` exists (or `.claude/product-marketing.md` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.\\n\\nBefore providing recommendations, identify:\\n\\n1. **Form Type**\\n - Lead capture (gated content, newsletter)\\n - Contact form\\n - Demo/sales request\\n - Application form\\n - Survey/feedback\\n - Checkout form\\n - Quote request\\n\\n2. **Current State**\\n - How many fields?\\n - What's the current completion rate?\\n - Mobile vs. desktop split?\\n - Where do users abandon?\\n\\n3. **Business Context**\\n - What happens with form submissions?\\n - Which fields are actually used in follow-up?\\n - Are there compliance/legal requirements?\\n\\n---\\n\\n## Core Principles\\n\\n### 1. Every Field Has a Cost\\nEach field reduces completion rate. Rule of thumb:\\n- 3 fields: Baseline\\n- 4-6 fields: 10-25% reduction\\n- 7+ fields: 25-50%+ reduction\\n\\nFor each field, ask:\\n- Is this absolutely necessary before we can help them?\\n- Can we get this information another way?\\n- Can we ask this later?\\n\\n### 2. Value Must Exceed Effort\\n- Clear value proposition above form\\n- Make what they get obvious\\n- Reduce perceived effort (field count, labels)\\n\\n### 3. Reduce Cognitive Load\\n- One question per field\\n- Clear, conversational labels\\n- Logical grouping and order\\n- Smart defaults where possible\\n\\n---\\n\\n## Field-by-Field Optimization\\n\\n### Email Field\\n- Single field, no confirmation\\n- Inline validation\\n- Typo detection (did you mean gmail.com?)\\n- Proper mobile keyboard\\n\\n### Name Fields\\n- Single \\\"Name\\\" vs. First/Last — test this\\n- Single field reduces friction\\n- Split needed only if personalization requires it\\n\\n### Phone Number\\n- Make optional if possible\\n- If required, explain why\\n- Auto-format as they type\\n- Country code handling\\n\\n### Company/Organization\\n- Auto-suggest for faster entry\\n- Enrichment after submission (Clearbit, etc.)\\n- Consider inferring from email domain\\n\\n### Job Title/Role\\n- Dropdown if categories matter\\n- Free text if wide variation\\n- Consider making optional\\n\\n### Message/Comments (Free Text)\\n- Make optional\\n- Reasonable character guidance\\n- Expand on focus\\n\\n### Dropdown Selects\\n- \\\"Select one...\\\" placeholder\\n- Searchable if many options\\n- Consider radio buttons if < 5 options\\n- \\\"Other\\\" option with text field\\n\\n### Checkboxes (Multi-select)\\n- Clear, parallel labels\\n- Reasonable number of options\\n- Consider \\\"Select all that apply\\\" instruction\\n\\n---\\n\\n## Form Layout Optimization\\n\\n### Field Order\\n1. Start with easiest fields (name, email)\\n2. Build commitment before asking more\\n3. Sensitive fields last (phone, company size)\\n4. Logical grouping if many fields\\n\\n### Labels and Placeholders\\n- Labels: Keep visible (not just placeholder) — placeholders disappear when typing, leaving users unsure what they're filling in\\n- Placeholders: Examples, not labels\\n- Help text: Only when genuinely helpful\\n\\n**Good:**\\n```\\nEmail\\n[name@company.com]\\n```\\n\\n**Bad:**\\n```\\n[Enter your email address] ← Disappears on focus\\n```\\n\\n### Visual Design\\n- Sufficient spacing between fields\\n- Clear visual hierarchy\\n- CTA button stands out\\n- Mobile-friendly tap targets (44px+)\\n\\n### Single Column vs. Multi-Column\\n- Single column: Higher completion, mobile-friendly\\n- Multi-column: Only for short related fields (First/Last name)\\n- When in doubt, single column\\n\\n---\\n\\n## Multi-Step Forms\\n\\n### When to Use Multi-Step\\n- More than 5-6 fields\\n- Logically distinct sections\\n- Conditional paths based on answers\\n- Complex forms (applications, quotes)\\n\\n### Multi-Step Best Practices\\n- Progress indicator (step X of Y)\\n- Start with easy, end with sensitive\\n- One topic per step\\n- Allow back navigation\\n- Save progress (don't lose data on refresh)\\n- Clear indication of required vs. optional\\n\\n### Progressive Commitment Pattern\\n1. Low-friction start (just email)\\n2. More detail (name, company)\\n3. Qualifying questions\\n4. Contact preferences\\n\\n---\\n\\n## Error Handling\\n\\n### Inline Validation\\n- Validate as they move to next field\\n- Don't validate too aggressively while typing\\n- Clear visual indicators (green check, red border)\\n\\n### Error Messages\\n- Specific to the problem\\n- Suggest how to fix\\n- Positioned near the field\\n- Don't clear their input\\n\\n**Good:** \\\"Please enter a valid email address (e.g., name@company.com)\\\"\\n**Bad:** \\\"Invalid input\\\"\\n\\n### On Submit\\n- Focus on first error field\\n- Summarize errors if multiple\\n- Preserve all entered data\\n- Don't clear form on error\\n\\n---\\n\\n## Submit Button Optimization\\n\\n### Button Copy\\nWeak: \\\"Submit\\\" | \\\"Send\\\"\\nStrong: \\\"[Action] + [What they get]\\\"\\n\\nExamples:\\n- \\\"Get My Free Quote\\\"\\n- \\\"Download the Guide\\\"\\n- \\\"Request Demo\\\"\\n- \\\"Send Message\\\"\\n- \\\"Start Free Trial\\\"\\n\\n### Button Placement\\n- Immediately after last field\\n- Left-aligned with fields\\n- Sufficient size and contrast\\n- Mobile: Sticky or clearly visible\\n\\n### Post-Submit States\\n- Loading state (disable button, show spinner)\\n- Success confirmation (clear next steps)\\n- Error handling (clear message, focus on issue)\\n\\n---\\n\\n## Trust and Friction Reduction\\n\\n### Near the Form\\n- Privacy statement: \\\"We'll never share your info\\\"\\n- Security badges if collecting sensitive data\\n- Testimonial or social proof\\n- Expected response time\\n\\n### Reducing Perceived Effort\\n- \\\"Takes 30 seconds\\\"\\n- Field count indicator\\n- Remove visual clutter\\n- Generous white space\\n\\n### Addressing Objections\\n- \\\"No spam, unsubscribe anytime\\\"\\n- \\\"We won't share your number\\\"\\n- \\\"No credit card required\\\"\\n\\n---\\n\\n## Form Types: Specific Guidance\\n\\n### Lead Capture (Gated Content)\\n- Minimum viable fields (often just email)\\n- Clear value proposition for what they get\\n- Consider asking enrichment questions post-download\\n- Test email-only vs. email + name\\n\\n### Contact Form\\n- Essential: Email/Name + Message\\n- Phone optional\\n- Set response time expectations\\n- Offer alternatives (chat, phone)\\n\\n### Demo Request\\n- Name, Email, Company required\\n- Phone: Optional with \\\"preferred contact\\\" choice\\n- Use case/goal question helps personalize\\n- Calendar embed can increase show rate\\n\\n### Quote/Estimate Request\\n- Multi-step often works well\\n- Start with easy questions\\n- Technical details later\\n- Save progress for complex forms\\n\\n### Survey Forms\\n- Progress bar essential\\n- One question per screen for engagement\\n- Skip logic for relevance\\n- Consider incentive for completion\\n\\n---\\n\\n## Mobile Optimization\\n\\n- Larger touch targets (44px minimum height)\\n- Appropriate keyboard types (email, tel, number)\\n- Autofill support\\n- Single column only\\n- Sticky submit button\\n- Minimal typing (dropdowns, buttons)\\n\\n---\\n\\n## Measurement\\n\\n### Key Metrics\\n- **Form start rate**: Page views → Started form\\n- **Completion rate**: Started → Submitted\\n- **Field drop-off**: Which fields lose people\\n- **Error rate**: By field\\n- **Time to complete**: Total and by field\\n- **Mobile vs. desktop**: Completion by device\\n\\n### What to Track\\n- Form views\\n- First field focus\\n- Each field completion\\n- Errors by field\\n- Submit attempts\\n- Successful submissions\\n\\n---\\n\\n## Output Format\\n\\n### Form Audit\\nFor each issue:\\n- **Issue**: What's wrong\\n- **Impact**: Estimated effect on conversions\\n- **Fix**: Specific recommendation\\n- **Priority**: High/Medium/Low\\n\\n### Recommended Form Design\\n- **Required fields**: Justified list\\n- **Optional fields**: With rationale\\n- **Field order**: Recommended sequence\\n- **Copy**: Labels, placeholders, button\\n- **Error messages**: For each field\\n- **Layout**: Visual guidance\\n\\n### Test Hypotheses\\nIdeas to A/B test with expected outcomes\\n\\n---\\n\\n## Experiment Ideas\\n\\n### Form Structure Experiments\\n\\n**Layout & Flow**\\n- Single-step form vs. multi-step with progress bar\\n- 1-column vs. 2-column field layout\\n- Form embedded on page vs. separate page\\n- Vertical vs. horizontal field alignment\\n- Form above fold vs. after content\\n\\n**Field Optimization**\\n- Reduce to minimum viable fields\\n- Add or remove phone number field\\n- Add or remove company/organization field\\n- Test required vs. optional field balance\\n- Use field enrichment to auto-fill known data\\n- Hide fields for returning/known visitors\\n\\n**Smart Forms**\\n- Add real-time validation for emails and phone numbers\\n- Progressive profiling (ask more over time)\\n- Conditional fields based on earlier answers\\n- Auto-suggest for company names\\n\\n---\\n\\n### Copy & Design Experiments\\n\\n**Labels & Microcopy**\\n- Test field label clarity and length\\n- Placeholder text optimization\\n- Help text: show vs. hide vs. on-hover\\n- Error message tone (friendly vs. direct)\\n\\n**CTAs & Buttons**\\n- Button text variations (\\\"Submit\\\" vs. \\\"Get My Quote\\\" vs. specific action)\\n- Button color and size testing\\n- Button placement relative to fields\\n\\n**Trust Elements**\\n- Add privacy assurance near form\\n- Show trust badges next to submit\\n- Add testimonial near form\\n- Display expected response time\\n\\n---\\n\\n### Form Type-Specific Experiments\\n\\n**Demo Request Forms**\\n- Test with/without phone number requirement\\n- Add \\\"preferred contact method\\\" choice\\n- Include \\\"What's your biggest challenge?\\\" question\\n- Test calendar embed vs. form submission\\n\\n**Lead Capture Forms**\\n- Email-only vs. email + name\\n- Test value proposition messaging above form\\n- Gated vs. ungated content strategies\\n- Post-submission enrichment questions\\n\\n**Contact Forms**\\n- Add department/topic routing dropdown\\n- Test with/without message field requirement\\n- Show alternative contact methods (chat, phone)\\n- Expected response time messaging\\n\\n---\\n\\n### Mobile & UX Experiments\\n\\n- Larger touch targets for mobile\\n- Test appropriate keyboard types by field\\n- Sticky submit button on mobile\\n- Auto-focus first field on page load\\n- Test form container styling (card vs. minimal)\\n\\n---\\n\\n## Task-Specific Questions\\n\\n1. What's your current form completion rate?\\n2. Do you have field-level analytics?\\n3. What happens with the data after submission?\\n4. Which fields are actually used in follow-up?\\n5. Are there compliance/legal requirements?\\n6. What's the mobile vs. desktop split?\\n\\n---\\n\\n## Related Skills\\n\\n- **signup**: For account creation forms\\n- **popups**: For forms inside popups/modals\\n- **cro**: For the page containing the form\\n- **ab-testing**: For testing form changes\\n\"}\n];\n",[],[463,774,800],"fb63d530-5d6d-11f1-a874-1607ee4eb77e","ref_4.ts","fb63d620-5d6d-11f1-a874-1607ee4eb77e",663,["D",1780286237546],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_4: SkillRef[] = [\n {\"skill\":\"churn-prevention\",\"ref\":\"dunning-playbook\",\"body\":\"# Dunning Playbook\\n\\nComplete guide to recovering failed payments and reducing involuntary churn.\\n\\n---\\n\\n## Why Dunning Matters\\n\\n- Failed payments cause 30-50% of all subscription churn\\n- Most failed payments are recoverable with the right strategy\\n- Subscription businesses lose an estimated $129 billion annually to involuntary churn\\n- Effective dunning recovers 50-60% of failed payments\\n\\n---\\n\\n## The Dunning Timeline\\n\\n```\\nDay -30 to -7: Pre-dunning (prevent failures)\\nDay 0: Payment fails → Smart retry #1 + Email #1\\nDay 1-3: Smart retry #2 + Email #2\\nDay 3-5: Smart retry #3\\nDay 5-7: Smart retry #4 + Email #3\\nDay 7-10: Final retry + Email #4 (final warning)\\nDay 10-14: Grace period ends → Account paused/cancelled\\nDay 14+: Win-back sequence begins\\n```\\n\\n---\\n\\n## Pre-Dunning: Prevent Failures Before They Happen\\n\\n### Card Expiry Management\\n\\n| Timing | Action |\\n|--------|--------|\\n| 30 days before expiry | Email: \\\"Your card ending in 4242 expires next month\\\" |\\n| 15 days before expiry | Email: \\\"Update your payment method to avoid interruption\\\" |\\n| 7 days before expiry | Email: \\\"Your card expires in 7 days — update now\\\" |\\n| 3 days before expiry | In-app banner: \\\"Payment method expiring soon\\\" |\\n\\n**Email template — Card expiring:**\\n```\\nSubject: Your card ending in 4242 expires soon\\n\\nHi [Name],\\n\\nThe card on file for your [Product] subscription expires on [date].\\n\\nUpdate your payment method now to avoid any interruption:\\n\\n[Update Payment Method →]\\n\\nThis takes less than 30 seconds.\\n\\n— [Product] Team\\n```\\n\\n### Card Updater Services\\n\\nMajor card networks offer automatic card update programs:\\n\\n| Service | Network | What It Does |\\n|---------|---------|--------------|\\n| Visa Account Updater (VAU) | Visa | Auto-updates stored card numbers and expiry dates |\\n| Mastercard Automatic Billing Updater (ABU) | Mastercard | Same for Mastercard |\\n| Amex Cardrefresher | American Express | Same for Amex |\\n\\n**Impact:** Reduces hard declines from expired/replaced cards by 30-50%.\\n\\n**How to enable:**\\n- **Stripe**: Automatic — enabled by default\\n- **Chargebee**: Enabled through gateway settings\\n- **Recurly**: Built-in, enabled by default\\n- **Braintree**: Contact processor to enable\\n\\n### Backup Payment Methods\\n\\nPrompt for a second payment method:\\n- During signup: \\\"Add a backup payment method\\\" (low conversion)\\n- After first successful payment: \\\"Protect your account with a backup card\\\" (better timing)\\n- After a failed payment is recovered: \\\"Add a backup to prevent future interruptions\\\" (best timing — they felt the pain)\\n\\n### Pre-Billing Notifications\\n\\nFor annual plans or high-value subscriptions:\\n- Email 7 days before renewal with amount and date\\n- Include link to update payment method\\n- Show what's included in the renewal\\n- Required by some regulations for auto-renewals\\n\\n---\\n\\n## Smart Retry Strategy\\n\\n### Decline Type Classification\\n\\n| Code | Type | Meaning | Retry? |\\n|------|------|---------|--------|\\n| `insufficient_funds` | Soft | Temporarily low balance | Yes — retry in 2-3 days |\\n| `card_declined` (generic) | Soft | Various temporary reasons | Yes — retry 3-4 times |\\n| `processing_error` | Soft | Gateway/network issue | Yes — retry within 24h |\\n| `expired_card` | Hard | Card is expired | No — request new card |\\n| `stolen_card` | Hard | Card reported stolen | No — request new card |\\n| `do_not_honor` | Soft/Hard | Bank refused (ambiguous) | Try once more, then ask for new card |\\n| `authentication_required` | Auth | SCA/3DS needed | Send customer to authenticate |\\n\\n### Retry Schedule by Provider\\n\\n**Stripe (Smart Retries — recommended):**\\n- Enable \\\"Smart Retries\\\" in Stripe Dashboard → Billing → Settings\\n- Stripe's ML model picks optimal retry timing based on billions of transactions\\n- Typically 4-8 retry attempts over 3-4 weeks\\n- Recovers ~15% more than fixed-schedule retries\\n\\n**Manual retry schedule (if no smart retries):**\\n\\n| Retry | Timing | Best Day/Time |\\n|-------|--------|--------------|\\n| 1 | Day 1 (24h after failure) | Morning, same day of week as original |\\n| 2 | Day 3 | Try a different time of day |\\n| 3 | Day 5 | After typical payday (1st, 15th) |\\n| 4 | Day 7 | Morning of the next business day |\\n| 5 (final) | Day 10 | Last attempt before grace period ends |\\n\\n**Retry timing insights:**\\n- Retry on the same day of month the original payment succeeded\\n- Retry after common paydays (1st and 15th of the month)\\n- Avoid retrying on weekends (lower approval rates)\\n- Morning retries (8-10am local time) perform slightly better\\n\\n---\\n\\n## Dunning Email Sequence\\n\\n### Email 1: Payment Failed (Day 0)\\n\\n**Tone:** Friendly, matter-of-fact. No alarm.\\n\\n```\\nSubject: Action needed — your payment didn't go through\\n\\nHi [Name],\\n\\nWe tried to charge your [card type] ending in [last 4] for your\\n[Product] subscription ($[amount]), but it didn't go through.\\n\\nThis happens sometimes — usually a quick card update fixes it.\\n\\n[Update Payment Method →]\\n\\nYour access isn't affected yet. We'll retry automatically, but\\nupdating your card is the fastest fix.\\n\\nNeed help? Just reply to this email.\\n\\n— [Product] Team\\n```\\n\\n### Email 2: Reminder (Day 3)\\n\\n**Tone:** Helpful, slightly more urgent.\\n\\n```\\nSubject: Quick reminder — update your payment for [Product]\\n\\nHi [Name],\\n\\nJust a heads-up — we still haven't been able to process your\\n$[amount] payment for [Product].\\n\\n[Update Payment Method →]\\n\\nTakes less than 30 seconds. Your [data/projects/team access]\\nis safe, but we'll need a valid payment method to keep your\\naccount active.\\n\\nQuestions? Reply here and we'll help.\\n\\n— [Product] Team\\n```\\n\\n### Email 3: Urgency (Day 7)\\n\\n**Tone:** Direct, clear consequences.\\n\\n```\\nSubject: Your [Product] account will be paused in 3 days\\n\\nHi [Name],\\n\\nWe've tried to process your payment several times, but your\\n[card type] ending in [last 4] keeps getting declined.\\n\\nIf we don't receive payment by [date], your account will be\\npaused and you'll lose access to:\\n\\n• [Key feature/data they use]\\n• [Their projects/workspace]\\n• [Team access for X members]\\n\\n[Update Payment Method Now →]\\n\\nYour data won't be deleted — you can reactivate anytime by\\nupdating your payment method.\\n\\n— [Product] Team\\n```\\n\\n### Email 4: Final Warning (Day 10)\\n\\n**Tone:** Final, clear, no guilt.\\n\\n```\\nSubject: Last chance to keep your [Product] account active\\n\\nHi [Name],\\n\\nThis is our last reminder. Your payment of $[amount] is past\\ndue, and your account will be paused tomorrow ([date]).\\n\\n[Update Payment Method →]\\n\\nAfter pausing:\\n• Your data is saved for [90 days]\\n• You can reactivate anytime\\n• Just update your card to restore access\\n\\nIf you intended to cancel, no action needed — your account\\nwill be paused automatically.\\n\\n— [Product] Team\\n```\\n\\n---\\n\\n## Grace Period Management\\n\\n### What Happens During Grace Period\\n\\n| Setting | Recommendation |\\n|---------|---------------|\\n| Duration | 7-14 days after final retry |\\n| Access | Degraded (read-only) or full access |\\n| Visibility | In-app banner: \\\"Payment past due — update to continue\\\" |\\n| Retry | Continue background retries during grace |\\n| Communication | Dunning emails continue |\\n\\n### Access Degradation Options\\n\\n**Option A: Full access during grace (recommended for B2B)**\\n- Lower friction, customer feels respected\\n- Higher recovery rate (they still see value)\\n- Risk: some customers exploit the grace period\\n\\n**Option B: Read-only access (recommended for B2C)**\\n- Can view but not create/edit\\n- Creates urgency without data loss fear\\n- Clear message: \\\"Update payment to resume full access\\\"\\n\\n**Option C: Immediate lockout (not recommended)**\\n- Aggressive, damages relationship\\n- Lower recovery rate\\n- Only appropriate for very low-cost plans\\n\\n### Post-Grace Period\\n\\n| Timing | Action |\\n|--------|--------|\\n| Grace period ends | Pause account (not delete) |\\n| Day 1 post-pause | \\\"Your account has been paused\\\" email |\\n| Day 7 post-pause | \\\"Your data is still here\\\" reminder |\\n| Day 30 post-pause | Win-back attempt with new offer |\\n| Day 60 post-pause | Final win-back |\\n| Day 90 post-pause | Data deletion warning (if applicable) |\\n\\n---\\n\\n## Provider-Specific Setup\\n\\n### Stripe\\n\\n**Enable Smart Retries:**\\n1. Dashboard → Settings → Billing → Subscriptions and emails\\n2. Enable \\\"Smart Retries\\\" under retry rules\\n3. Set failed payment emails in Dashboard → Settings → Emails\\n\\n**Custom retry rules (if not using Smart Retries):**\\n```\\nRetry 1: 3 days after failure\\nRetry 2: 5 days after failure\\nRetry 3: 7 days after failure\\nFinal: Mark subscription as unpaid after last retry\\n```\\n\\n**Webhook events to handle:**\\n- `invoice.payment_failed` — trigger dunning\\n- `invoice.paid` — cancel dunning, restore access\\n- `customer.subscription.updated` — status changes\\n- `customer.subscription.deleted` — final cancellation\\n\\n### Chargebee\\n\\n**Built-in dunning:**\\n1. Settings → Configure Chargebee → Retry Settings\\n2. Configure retry attempts and intervals\\n3. Settings → Configure Chargebee → Email Notifications → Dunning\\n\\n**Dunning options:**\\n- Automatic retries with configurable schedule\\n- Built-in dunning emails (customizable templates)\\n- Grace period configuration per plan\\n\\n### Paddle\\n\\n**Managed dunning:**\\n- Paddle handles retries and dunning automatically\\n- Limited customization (Paddle manages the relationship)\\n- Webhook: `subscription.payment_failed`, `subscription.cancelled`\\n- Best for hands-off approach\\n\\n### Recurly\\n\\n**Revenue Recovery:**\\n1. Configuration → Dunning Management\\n2. Set retry schedule per plan\\n3. Configure grace period and final action (pause vs cancel)\\n\\n**Advanced features:**\\n- Machine-learning retry optimization\\n- Per-plan dunning schedules\\n- Built-in Account Updater\\n\\n---\\n\\n## In-App Dunning\\n\\nDon't rely on email alone. Show payment failures in the app:\\n\\n### Banner Pattern\\n```\\n┌──────────────────────────────────────────────────────┐\\n│ ⚠ Your payment of $29 failed. Update your card to │\\n│ avoid losing access. [Update Payment →] [Dismiss] │\\n└──────────────────────────────────────────────────────┘\\n```\\n\\n**Rules:**\\n- Show on every page load during dunning period\\n- Allow dismiss (but show again next session)\\n- Direct link to payment update (fewest clicks possible)\\n- Don't block the product — let them continue using it\\n\\n### Modal Pattern (for final warning)\\n```\\n┌─────────────────────────────────────┐\\n│ │\\n│ Your account will be paused │\\n│ on [date] │\\n│ │\\n│ Update your payment method to │\\n│ keep access to your [X] projects │\\n│ and [Y] team members. │\\n│ │\\n│ [Update Payment Method] │\\n│ [Remind Me Later] │\\n│ │\\n└─────────────────────────────────────┘\\n```\\n\\n---\\n\\n## Measuring Dunning Performance\\n\\n### Key Metrics\\n\\n| Metric | How to Calculate | Target |\\n|--------|-----------------|--------|\\n| Recovery rate | Recovered payments / Total failed | 50-60% |\\n| Recovery rate by decline type | Recovered / Failed per type | Soft: 70%+, Hard: 40%+ |\\n| Time to recovery | Days from failure to successful payment | <5 days |\\n| Pre-dunning prevention rate | Prevented failures / Expected failures | 20-30% |\\n| Dunning email open rate | Opens / Sent per email | 60%+ |\\n| Dunning email click rate | Clicks / Opens per email | 30%+ |\\n| Revenue recovered (monthly) | Sum of recovered payment amounts | Track trend |\\n| Revenue lost to involuntary churn | Sum of failed + unrecovered amounts | Track trend |\\n\\n### Benchmarking\\n\\n**By company stage:**\\n\\n| Stage | Typical Involuntary Churn | Target After Optimization |\\n|-------|--------------------------|--------------------------|\\n| Early (< $1M ARR) | 3-5% of MRR/month | 1-2% |\\n| Growth ($1-10M ARR) | 2-4% of MRR/month | 0.5-1.5% |\\n| Scale ($10M+ ARR) | 1-3% of MRR/month | 0.3-0.8% |\\n\\n### ROI Calculation\\n\\n```\\nMonthly failed payment MRR: $10,000\\nCurrent recovery rate: 30% ($3,000 recovered)\\nTarget recovery rate: 60% ($6,000 recovered)\\nMonthly improvement: $3,000/month\\nAnnual improvement: $36,000/year\\nCost of dunning optimization: ~$200-500/month (tooling)\\nROI: 6-15x\\n```\\n\"},\n {\"skill\":\"cold-email\",\"ref\":\"benchmarks\",\"body\":\"# Benchmarks, Data & Expert Methods\\n\\n## Core Performance Metrics (2024–2025)\\n\\n| Metric | Average | Good | Excellent | Source |\\n| -------------------------- | ------- | ------ | --------- | ------------------------ |\\n| Open rate | 27.7% | 40–45% | 50%+ | Belkins, Snov.io |\\n| Reply rate | 4–5.8% | 5–10% | 10–15% | Belkins, Reachoutly |\\n| Reply rate (best-in-class) | — | — | 15–25%+ | Digital Bloom, Instantly |\\n| Positive reply % | ~48% | 55–60% | 62–65% | Digital Bloom |\\n| Meeting booking rate | 0.5–1% | 1–2% | 2.3%+ | Reachoutly |\\n| Bounce rate | 7.5% | <4% | <2% | Belkins |\\n\\n## Realistic Funnel Model\\n\\n500 emails → 100 opens (20%) → 25 replies (5%) → 8 positive replies (30%) → 4 meetings (50%) → 1 client (25% close). ~**0.2% end-to-end conversion** for average performers.\\n\\n## Performance Levers (ranked by impact)\\n\\n1. **Hook type** — Timeline hooks outperform problem hooks by 3.4x in meetings\\n2. **Personalization depth** — Up to 250% more replies\\n3. **Brevity** — 25–75 words optimal, 83% more replies under 75 words\\n4. **Targeting precision** — ≤50 contacts per campaign = 2.76x higher reply rates\\n5. **Follow-up strategy** — First follow-up adds 49% more replies\\n6. **Reading level** — 3rd–5th grade = 67% more replies\\n7. **Send timing** — Thursday peaks at 6.87% reply rate\\n\\n## Declining Effectiveness Trend\\n\\nReply rates dropped from 7–8% (2020–2022) to 4–5.8% (2024–2025), ~15% YoY decline. Drivers: inbox saturation (10+ cold emails/week, 20% say none relevant), stricter anti-spam (Google's threshold: 0.1% complaints), AI email flood (more volume, less quality signal). Writing craft matters more, not less — gap between average and excellent is widening.\\n\\n## Response Rates by Seniority\\n\\n- **Entry-level:** Highest engagement at 8% reply, 50% open\\n- **C-level:** 23% more likely to respond than non-C-suite when they engage (6.4% vs 5.2%)\\n- **CTOs/VP Tech:** 7.68% reply\\n- **CEOs/Founders:** 7.63% reply\\n- **Heads of Sales:** 6.60% (most targeted role, highest saturation)\\n\\n## Industry Variation\\n\\n**Highest responding:** Nonprofits (16.5%+), legal (10%), EdTech (7.8%), chemical (7.3%), manufacturing (6.1%).\\n**Lowest responding:** SaaS (3.5%), financial services (3.4%), IT services (3.5%).\\n\\n## Top 15 Mistakes (ranked by impact)\\n\\n1. **Too long** — 70% of emails above 10th-grade level. Under 75 words = 83% more replies\\n2. **Too self-focused** — \\\"We are a leading...\\\" signals sales pitch. Count I/We sentences\\n3. **No clear value prop** — 71% of decision-makers ignore irrelevant emails\\n4. **Generic templates** — {{FirstName}} isn't personalization. Recipients detect instantly\\n5. **Feature dumping** — \\\"Great reps lead with problems\\\" (Lavender). One proof point beats ten features\\n6. **False personalization** — \\\"Loved your post!\\\" without specifics is transparent\\n7. **Asking too much too soon** — 30-min call in first email = \\\"proposing on first date\\\"\\n8. **Pushy language** — \\\"Act Now\\\" stacking increases spam flagging by 67%\\n9. **No CTA** — Without a clear next step, momentum dies\\n10. **\\\"Just checking in\\\" follow-ups** — \\\"I never heard back\\\" = 12% drop in bookings\\n11. **Wrong tone for audience** — Founder ≠ RevOps lead ≠ sales leader\\n12. **Jargon/buzzwords** — \\\"Leverage synergistic platform\\\" → \\\"We help you book more meetings\\\"\\n13. **Unsubstantiated claims** — \\\"300% more leads\\\" without proof triggers skepticism\\n14. **Too many contacts per company** — 1–2 people = 7.8% reply; 10+ = 3.8%\\n15. **Fake urgency** — Fake \\\"Re:\\\" / \\\"Fwd:\\\" / countdown timers destroy trust\\n\\n## Cultural Calibration\\n\\n| Factor | US | UK | Germany/DACH | Scandinavia |\\n| ------------ | --------------- | ------------------------ | -------------------- | ----------------------- |\\n| Tone | Direct, casual | Polite, professional | Precise, data-driven | Fact-based, egalitarian |\\n| Length | Shorter, blunt | Longer, insight-led | Detail-oriented | Concise but substantive |\\n| Social proof | Outcome numbers | Research-led credibility | Technical precision | Shared values |\\n\\nNorth America: 4.1% response. Europe: 3.1%. Asia-Pacific: 2.8%. Shorter, more direct sequences work better in US. UK needs more insight/personality. GDPR affects European tone.\\n\\n## Expert Quick Reference\\n\\n| Expert | Core Method | Best For |\\n| -------------- | --------------------------------------------------------------- | ----------------------------------------------- |\\n| Alex Berman | 3C's: Compliment → Case Study → CTA | High-ticket B2B services, agencies |\\n| Josh Braun | \\\"Poke the Bear\\\" — neutral questions exposing invisible problems | Empathy-driven consultative selling |\\n| Kyle Coleman | Systematic research + AI personalization at scale | Bridging mass outreach and deep personalization |\\n| Becc Holland | Psychographic personalization, Premise Buckets | Combining personalization with relevance |\\n| Will Allred | Data-driven coaching, Mouse Trap, Vanilla Ice Cream | Any context; universal frameworks |\\n| Justin Michael | 1–3 sentence hyper-brevity, quote their own words | High-velocity SDR teams at scale |\\n| Sam Nelson | Agoge Sequence — Triple on Day 1 (email + LinkedIn + call) | Multi-channel, tiered personalization |\\n\"},\n {\"skill\":\"cold-email\",\"ref\":\"follow-up-sequences\",\"body\":\"# Follow-Up Sequences\\n\\n55% of replies come from follow-ups, not the initial email. Yet 48% of salespeople never follow up even once.\\n\\n## How Many: 3–5 Total Emails\\n\\n- Highest single-email reply rate: **8.4%** (Belkins).\\n- 4–7 email campaigns achieve **27% reply rates** vs 9% for 1–3 emails (Woodpecker, 20M emails).\\n- By 4th follow-up, response rates drop **55%** and spam complaints **triple**.\\n- Resolution: longer sequences catch different timing windows. Cap at 4 follow-ups (5 total emails). Each must add genuinely new value.\\n\\n## Optimal Cadence\\n\\nIncrease the gap between each touch:\\n\\n| Touch | Day | Notes |\\n| ------------- | ----- | ---------------------------------------------- |\\n| Initial email | 0 | Maximum personalization investment |\\n| Follow-up 1 | 3 | Waiting 3 days increases response by up to 31% |\\n| Follow-up 2 | 7–8 | Different angle |\\n| Follow-up 3 | 14 | New value piece |\\n| Follow-up 4 | 21–28 | Breakup email |\\n\\n**Best days:** Tuesday–Thursday (Thursday peaks at 6.87% reply rate).\\n**Best times:** 9–11 AM or 1–3 PM in prospect's local time.\\n**Avoid:** Monday mornings (inbox overload), Friday afternoons (checked out).\\n\\n## Angle Rotation\\n\\nEach follow-up must stand alone while building toward the goal. Never just \\\"bump this up.\\\"\\n\\n| Email | Angle | Purpose |\\n| ----------- | ---------------------------------------------------------- | -------------------------- |\\n| Initial | Personalized hook + core value prop + soft CTA | Introduce problem/solution |\\n| Follow-up 1 | Different angle, new value piece (stat, insight, resource) | Show additional benefit |\\n| Follow-up 2 | Social proof / case study from similar company | Build credibility |\\n| Follow-up 3 | New insight, industry trend, or relevant resource | Demonstrate expertise |\\n| Follow-up 4 | Breakup — acknowledge silence, leave door open | Trigger loss aversion |\\n\\nAdd only **one new value proposition per email** (SalesBread). This naturally forces different angles.\\n\\n## The Breakup Email\\n\\nLeverages loss aversion — removing pressure while creating scarcity through withdrawal. Close.com reports **10–15% response rates** from breakup emails with cold prospects.\\n\\n**Structure:**\\n\\n1. Acknowledge you've reached out multiple times\\n2. Validate their potential lack of interest\\n3. State this is your final email for now\\n4. Leave the door open\\n\\n**Example:**\\n\\n> I haven't heard back, so I'll assume now isn't the right time. Before I close the loop: [1-sentence insight or resource]. If that changes things, feel free to reply. Otherwise, no hard feelings — good luck with [their goal].\\n\\n**1-2-3 Format** (reduces friction to near zero):\\n\\n> Since I haven't heard back, I'll keep it simple. Reply with a number:\\n>\\n> 1 — Interested, let's talk\\n> 2 — Not now, check back in 3 months\\n> 3 — Not interested, please stop\\n\\n**Critical rule:** If you send a breakup email, honor it. Do not contact the prospect again.\\n\\n## Phrases That Kill Response Rates\\n\\n- \\\"I never heard back\\\" → **12% drop** in meeting booking rate (Gong)\\n- \\\"Just checking in\\\" → Zero value, signals laziness\\n- \\\"Bumping this to the top of your inbox\\\" → Presumptuous\\n- \\\"Did you see my last email?\\\" → Guilt-tripping\\n- \\\"Following up on my previous message\\\" → Generic, adds nothing\\n\\n## CTA Adjustment by Seniority\\n\\n**Executives/founders:** Ultra-low-effort, curiosity-driven. \\\"Curious?\\\" or \\\"Worth 2 min?\\\"\\n\\n**Mid-level managers:** More specific value. \\\"Want me to walk through how [Company] saved 15 hours/week?\\\"\\n\\nHigher in the org chart = less friction you can ask for.\\n\"},\n {\"skill\":\"cold-email\",\"ref\":\"frameworks\",\"body\":\"# Cold Email Copywriting Frameworks\\n\\nFrameworks beat templates — they teach thinking patterns, not copy-paste shortcuts.\\n\\n## PAS — Problem, Agitate, Solution (default)\\n\\n**Structure:** Identify pain → Amplify consequences → Present solution + soft CTA.\\n**Best for:** Problem-aware but not solution-aware prospects. The workhorse framework.\\n\\n> Most VP Sales at companies your size spend 5+ hours/week on manual CRM reporting. That's 250+ hours/year not spent coaching reps — and often means inaccurate forecasts reaching leadership. We built a tool that auto-generates CRM reports in real time. Teams like Datadog reduced reporting time by 80%. Would it make sense to see how?\\n\\n## BAB — Before, After, Bridge\\n\\n**Structure:** Current painful situation → Ideal future → Your product as the bridge.\\n**Best for:** Transformation-driven offers with clear before/after. Emotional decision-makers.\\n\\n> Right now, your team is likely spending hours manually sourcing leads — feast or famine each quarter. Imagine qualified leads arriving daily on autopilot, reps spending 100% of their time selling. That's what our platform does. Companies like HubSpot saw a 40% pipeline increase within 90 days. Can I show you how?\\n\\n## QVC — Question, Value, CTA\\n\\n**Structure:** Targeted pain question → Brief value → Direct next step.\\n**Best for:** C-suite prospects who prefer brevity. Qualify interest immediately.\\n\\n> Are your SDRs spending more time researching than selling? We help sales teams automate prospect research so reps focus on conversations. Clients see 3x more meetings per rep per week. Worth a 10-minute demo?\\n\\n## AIDA — Attention, Interest, Desire, Action\\n\\n**Structure:** Hook/stat → Address specific challenge → Social proof/outcome → Clear CTA.\\n**Best for:** Data-driven prospects, high-ticket pitches with strong stats.\\n\\n> Companies in pharma lose 30% of leads due to manual outreach. Given {{Company}}'s growth this quarter, pipeline velocity is likely top of mind. Customers like Pfizer use our platform to automate lead qualification — cutting time-to-contact by 60%. Worth a 15-minute call?\\n\\n## PPP — Praise, Picture, Push\\n\\n**Structure:** Genuine compliment → How things could be better → Gentle push to action.\\n**Best for:** Senior prospects who respond to relationship-building. Requires genuine trigger.\\n\\n> Your keynote on scaling SDR teams was spot-on — especially on ramp time as the hidden cost. What if you could cut that in half? Our in-inbox coach helps new reps write effective emails from day one with real-time scoring. Open to a quick chat about how this could support your growth?\\n\\n## Star-Story-Solution\\n\\n**Structure:** Introduce character (customer) → Tell challenge narrative → Reveal results.\\n**Best for:** Strong customer success stories. Humanizes the pitch.\\n\\n> Last year, Sarah — VP Sales at a Series B startup — had 5 SDRs competing against a rival with 20. Her team was getting crushed on volume. They adopted our AI prospecting tool and sent hyper-personalized emails at 3x pace without losing quality. Within 90 days, they booked more meetings than their competitor's entire team. Happy to share how this could work for {{Company}}.\\n\\n## SCQ — Situation, Complication, Question\\n\\n**Structure:** Current reality → Complicating challenge → Question that speaks to need → Optional answer.\\n**Best for:** Consultative selling. Mirrors how professionals present to leadership.\\n\\n> Your team doubled this year. That usually means onboarding is eating into selling time. How are you handling ramp for new hires?\\n\\n## ACCA — Awareness, Comprehension, Conviction, Action\\n\\n**Structure:** Contrarian hook → Explain benefit simply → Provide proof → Strong CTA.\\n**Best for:** Analytical buyers who need evidence (engineers, CFOs, ops leaders).\\n\\n> Most sales teams measure rep activity. The top 5% measure rep efficiency instead. When Acme switched, they booked 40% more meetings with fewer emails. Worth seeing how?\\n\\n## 3C's (Alex Berman)\\n\\n**Structure:** Compliment → Case Study → CTA.\\n**Best for:** Agency/services cold outreach. Case study does the heavy lifting.\\n\\n> Big fan of [Company]. We just built an app for [Competitor] that does XYZ. I have a few more ideas. Interested?\\n\\n## Mouse Trap (Lavender/Will Allred)\\n\\n**Structure:** Observation + Binary value-prop question. 1–2 sentences total.\\n**Best for:** Maximum brevity. Impulsive reply based on curiosity.\\n\\n> Looks like you're hiring reps. Would it be helpful to get a more granular look at how they're ramping on email?\\n\\n## Justin Michael Method\\n\\n**Structure:** Trigger/Pain → Solution hint → Binary CTA. 1–3 sentences, no intro.\\n**Best for:** High-velocity SDR teams. Mobile-optimized. Deliberately polarizing.\\n\\nSpend max 1 minute on personalization. Use industry/persona-level signals. For top-tier prospects, quote their own words from interviews — they almost always respond.\\n\\n## Vanilla Ice Cream (Lavender)\\n\\n**Structure:** Observation → Problem/Insight → Credibility → Solution → Call-to-Conversation.\\n**Best for:** Universal \\\"base\\\" framework that works everywhere. Five parts.\\n\\n## PASTOR (Ray Edwards)\\n\\n**Structure:** Problem → Amplify → Story → Testimony → Offer → Response.\\n**Best for:** Longer-form or multi-email sequences. Consulting, education, complex B2B services. Each element can be developed across separate touches.\\n\"},\n {\"skill\":\"cold-email\",\"ref\":\"personalization\",\"body\":\"# Personalization at Scale\\n\\nPersonalization drives **50–250% more replies** (Lavender). The key insight: **if your personalization has nothing to do with the problem you solve, it's just an attention hack** (Clay).\\n\\n## Four Levels of Personalization\\n\\n### Level 1 — Basic (merge tags)\\n\\nFirst name, company name, job title. Table stakes, no longer differentiating. ~5% lift.\\n\\n### Level 2 — Industry/segment\\n\\nIndustry-specific pain points, trends, regulatory challenges. Scalable via micro-segmentation.\\n\\n> Most {{industry}} teams struggle with {{lead gen problem}}, which often leads to wasted effort.\\n\\n### Level 3 — Role-level\\n\\nChallenges specific to their role and seniority.\\n\\n> As Head of Sales, keeping pipeline steady is probably your biggest headache. Your RevOps team is small, so you're likely wearing multiple hats during scaling.\\n\\n### Level 4 — Individual (gold standard)\\n\\nSpecific, timely observations about that person connected to the problem you solve.\\n\\n> Noticed you're hiring 3 SDRs — sounds like you're scaling outbound fast. Most teams hit follow-up fatigue during onboarding.\\n\\n## Research Signal Stack\\n\\n| Signal | Where to find it | How to use it |\\n| ----------------- | ---------------------------------- | ---------------------------------------------------------------------------- |\\n| Recent funding | Crunchbase, LinkedIn, press | \\\"Congrats on Series B — scaling teams fast usually creates X challenge\\\" |\\n| Job postings | LinkedIn Jobs, careers page | \\\"Noticed you're hiring 3 SDRs — sounds like you're scaling outbound\\\" |\\n| Tech stack | BuiltWith, Wappalyzer, HG Insights | \\\"I see you're using HubSpot — most teams at your stage hit a ceiling with X\\\" |\\n| LinkedIn activity | Posts, comments, job changes | \\\"Really enjoyed your post about X\\\" |\\n| Company news | Google News, press releases | \\\"Congrats on acquiring X — integrating teams usually creates Y challenge\\\" |\\n| Podcast/talks | Google, YouTube, podcasts | \\\"Caught your talk at SaaStr on X — really insightful\\\" |\\n| Website changes | Manual review | \\\"Your new pricing page caught my eye — curious how it's converting\\\" |\\n\\n## The 3-Minute Personalization System\\n\\nFrom \\\"30 Minutes to President's Club\\\":\\n\\n**Step 1:** Build a research stack of top 10 buying signals — 5 company triggers, 5 person triggers. Stack-rank by relevance.\\n\\n**Step 2:** Build a 3x3 template: (1) personalization attached to a problem, (2) problem you solve, (3) one-sentence solution + low-friction CTA.\\n\\n**Step 3:** Create 5 \\\"trigger templates\\\" — pre-written personalization paragraphs for each trigger, with a smooth segue into the problem.\\n\\nThe personalization must logically connect to the problem. This creates 5 reusable triggers with the rest of the email constant. A top SDR writes a personalized email in **under 3 minutes**.\\n\\n## The Four -Graphic Principles (Becc Holland)\\n\\n- **Demographic** — Age, profession, background\\n- **Technographic** — Tech stack, tools used\\n- **Firmographic** — Company size, funding, industry, growth stage\\n- **Psychographic** — Values, passions, beliefs (highest-impact dimension)\\n\\nTapping into what prospects are passionate about drives significantly higher response rates.\\n\\n## Observation-Based Openers (highest performing)\\n\\n**Trigger-event:** \\\"Congrats on the recent funding round — scaling the team from here is exciting, and I imagine [challenge] is top of mind.\\\"\\n\\n**Observation:** \\\"Your recent post about [topic] resonated — especially the part about [detail]. Got me thinking about how that applies to [challenge].\\\"\\n\\n**Industry insight:** \\\"Most [role titles] I talk to spend [X hours/week] on [problem] — curious if that matches your experience at [Company].\\\"\\n\\n## What Feels Fake (avoid)\\n\\n- AI-generated emails with similar phrasing (\\\"I hope this email finds you well\\\")\\n- Generic attention hacks disconnected from problem (\\\"Cool that you went to UCLA!\\\" → pitch)\\n- Over-personalizing to creepiness\\n- \\\"I saw your LinkedIn profile and wanted to reach out\\\" — signals mass automation\\n\\n## The \\\"So What?\\\" Test\\n\\nAfter writing any opening line, read from prospect's perspective: \\\"So what? Why would I care?\\\" If the answer is nothing, rewrite.\\n\"},\n {\"skill\":\"cold-email\",\"ref\":\"subject-lines\",\"body\":\"# Subject Line Optimization\\n\\nThe subject line determines whether the email gets read. The data is counterintuitive: **short, boring, internal-looking subject lines win decisively.**\\n\\n## Length: 2–4 words\\n\\n- 2-word subject lines get **60% more opens** than 5-word (Lavender).\\n- Going from 2 to 4 words reduces replies by **17.5%**.\\n- 2–4 words yield **46% open rates** vs 34% for 10 words (Belkins, 5.5M emails).\\n- Mobile truncates at 30–35 characters — brevity is practical necessity.\\n\\n## Internal Camouflage Principle\\n\\nSubject lines that look like they came from a colleague, not a vendor, double open rates (Gong). Buyers mentally categorize before opening — if it looks like sales, it's filtered.\\n\\n**High-performing examples:** \\\"reply rates\\\" · \\\"trial delays\\\" · \\\"hiring ops\\\" · \\\"employee turnover\\\" · \\\"Q2 forecast\\\" · \\\"new patients\\\" · \\\"personalization issue\\\" · \\\"second page\\\"\\n\\n## Capitalization: lowercase wins\\n\\nAll-lowercase has highest open rates (Gong, 85M+ emails). Lowercase looks more personal/internal. For cold outreach specifically, lowercase beats title case.\\n\\n## Personalization: context over name\\n\\nPersonalized subject lines boost opens **26–50%**, but type matters:\\n\\n- **First name in subject line → 12% fewer replies.** Signals automation.\\n- **Contextual personalization works:** pain points, competitors, trigger events, industry challenges.\\n- Use {{painPoint}}, {{competitor}}, {{commonGround}} — not {{firstName}}.\\n\\n## Questions: only when highly specific\\n\\nData conflicts: Belkins says questions perform well (46% open rate). Lavender says questions lower opens by **56%**. Resolution: **specific pain questions work** (\\\"Need help with {{challenge}}?\\\"), **generic questions fail** (\\\"Quick question?\\\" / \\\"Have 15 minutes?\\\"). Default to statements.\\n\\n## What to Avoid\\n\\n| Anti-pattern | Impact |\\n| ---------------------------------------------- | --------------------------- |\\n| Salesy language (\\\"increase,\\\" \\\"boost,\\\" \\\"ROI\\\") | -17.9% opens |\\n| Urgency words (\\\"ASAP,\\\" \\\"urgent\\\") | Below 36% opens |\\n| Excessive punctuation (\\\"!!!\\\" or \\\"??\\\") | -36% opens |\\n| Numbers and percentages | -46% opens |\\n| Emojis | Hurt B2B professionalism |\\n| Pitching product in subject | -57% replies |\\n| Empty/no subject line | +30% opens but -12% replies |\\n| Spam triggers (\\\"free,\\\" \\\"guarantee,\\\" \\\"act now\\\") | Deliverability risk |\\n\\n## C-Suite Subject Lines\\n\\nExecutives receive 300–400 emails daily, decide in seconds. They respond **23% more often** than non-C-suite when emails pass their filter (6.4% reply rate).\\n\\nWhat works: ultra-concise, human, understated. \\\"{{companyInitiative}}\\\" · \\\"thank you\\\" · \\\"an update\\\" · \\\"a question\\\" · reference to a specific project or trigger event.\\n\\nAnything \\\"salesy\\\" is immediately rejected.\\n\"},\n {\"skill\":\"competitor-profiling\",\"ref\":\"templates\",\"body\":\"# Profile Templates\\n\\nReady-to-use templates for competitor profile sections and the summary document.\\n\\n## Contents\\n- Quick Scan Template\\n- Summary Comparison Table\\n- Positioning Map\\n- Competitive SWOT\\n- Profile Update Changelog\\n\\n---\\n\\n## Quick Scan Template\\n\\nAbbreviated profile for when speed matters more than depth.\\n\\n```markdown\\n# [Competitor Name] — Quick Profile\\n\\n**URL**: [website]\\n**Generated**: [date]\\n\\n## At a Glance\\n\\n| Metric | Value |\\n|--------|-------|\\n| Tagline | [from homepage] |\\n| Target audience | [inferred from copy] |\\n| Pricing starts at | [lowest paid tier] |\\n| Free tier/trial | [yes/no + details] |\\n| Domain rank | [from DataForSEO] |\\n| Est. organic traffic | [monthly] |\\n| Organic keywords (top 10) | [count] |\\n| Referring domains | [count] |\\n\\n## Positioning\\n\\n**Headline**: \\\"[exact homepage headline]\\\"\\n**Subheadline**: \\\"[exact subheadline]\\\"\\n**Positioning angle**: [1-2 sentence summary of how they position]\\n\\n## Pricing Summary\\n\\n| Tier | Price | Notable Inclusions |\\n|------|-------|-------------------|\\n| [tier] | [price] | [key items] |\\n| [tier] | [price] | [key items] |\\n\\n## Key Takeaway\\n\\n[2-3 sentences: what makes this competitor notable, where they're strong, where they're weak]\\n```\\n\\n---\\n\\n## Summary Comparison Table\\n\\nUse after profiling all competitors to create a side-by-side view.\\n\\n```markdown\\n# Competitive Landscape Summary\\n\\n**Generated**: [date]\\n**Your product**: [name]\\n**Competitors profiled**: [count]\\n\\n## Side-by-Side Comparison\\n\\n| Dimension | [Your Product] | [Competitor 1] | [Competitor 2] | [Competitor 3] |\\n|-----------|---------------|----------------|----------------|----------------|\\n| **Tagline** | [yours] | [theirs] | [theirs] | [theirs] |\\n| **Target audience** | [yours] | [theirs] | [theirs] | [theirs] |\\n| **Positioning** | [angle] | [angle] | [angle] | [angle] |\\n| **Starting price** | $[X]/mo | $[X]/mo | $[X]/mo | $[X]/mo |\\n| **Free tier** | [yes/no] | [yes/no] | [yes/no] | [yes/no] |\\n| **Domain rank** | [score] | [score] | [score] | [score] |\\n| **Est. organic traffic** | [number] | [number] | [number] | [number] |\\n| **Referring domains** | [count] | [count] | [count] | [count] |\\n| **G2 rating** | [score] | [score] | [score] | [score] |\\n| **Key strength** | [one-liner] | [one-liner] | [one-liner] | [one-liner] |\\n| **Key weakness** | [one-liner] | [one-liner] | [one-liner] | [one-liner] |\\n```\\n\\n---\\n\\n## Positioning Map\\n\\nVisual representation of where competitors sit along two key dimensions. Choose the two axes most relevant to your market.\\n\\n### Common Axis Pairs\\n\\n| Market Type | X-Axis | Y-Axis |\\n|-------------|--------|--------|\\n| SaaS tools | Simple → Complex | Cheap → Expensive |\\n| Developer tools | Low-code → Code-first | Individual → Team |\\n| B2B platforms | SMB-focused → Enterprise-focused | Point solution → Platform |\\n| Content tools | Template-driven → Custom | Self-serve → Managed |\\n\\n### Format\\n\\n```markdown\\n## Positioning Map\\n\\n**Axes**: [X-axis label] vs. [Y-axis label]\\n\\n [Y-axis high label]\\n │\\n │\\n [Competitor A] │ [Competitor B]\\n │\\n ───────────────────────┼───────────────────────\\n [X-axis low] │ [X-axis high]\\n │\\n [Your Product] │ [Competitor C]\\n │\\n [Y-axis low label]\\n\\n### Interpretation\\n- [1-2 sentences about what the map reveals]\\n- [where the whitespace / opportunity is]\\n```\\n\\n---\\n\\n## Competitive SWOT\\n\\nPer-competitor SWOT relative to your product.\\n\\n```markdown\\n## SWOT: [Competitor] vs. [Your Product]\\n\\n### Strengths (theirs vs. ours)\\n- [Where they genuinely outperform us — be honest]\\n\\n### Weaknesses (theirs vs. ours)\\n- [Where they fall short compared to us — with evidence]\\n\\n### Opportunities (for us)\\n- [Gaps in their offering we can exploit]\\n- [Segments they're ignoring]\\n- [Messaging angles they're missing]\\n\\n### Threats (from them)\\n- [Areas where they're improving fast]\\n- [Features they're building that overlap with us]\\n- [Market moves that could shift perception]\\n```\\n\\n---\\n\\n## Profile Update Changelog\\n\\nAppend to the bottom of any profile when updating it.\\n\\n```markdown\\n---\\n\\n## Change Log\\n\\n| Date | What Changed | Source |\\n|------|-------------|--------|\\n| [date] | Pricing increased from $X to $Y | Pricing page re-scrape |\\n| [date] | Launched [feature] | Changelog scrape |\\n| [date] | Domain rank changed from X to Y | DataForSEO re-pull |\\n| [date] | Added [integration] | Integrations page re-scrape |\\n```\\n\"},\n {\"skill\":\"competitor-profiling\",\"ref\":\"tool-reference\",\"body\":\"# MCP Tool Reference for Competitor Profiling\\n\\nQuick reference for the Firecrawl and DataForSEO MCP tools used in competitor profiling.\\n\\n## Contents\\n- Firecrawl Tools (site scraping)\\n- DataForSEO Tools (SEO & market data)\\n- Recommended Execution Order\\n- Error Handling\\n\\n---\\n\\n## Firecrawl Tools\\n\\n### firecrawl_map\\n**Purpose**: Discover all URLs on a competitor's site to identify key pages.\\n**When to use**: First step for every competitor — before scraping individual pages.\\n**Key output**: List of URLs with their page types/paths.\\n**Tip**: Look for paths containing `/pricing`, `/features`, `/about`, `/customers`, `/integrations`, `/blog`, `/changelog`.\\n\\n### firecrawl_scrape\\n**Purpose**: Extract content from a single page as clean markdown.\\n**When to use**: After mapping, scrape each key page individually.\\n**Key output**: Page content in markdown format — headlines, body text, structured data.\\n**Tip**: Scrape homepage first — it reveals positioning, audience, and social proof in one shot.\\n\\n### firecrawl_search\\n**Purpose**: Search the web for specific content about a competitor.\\n**When to use**: Finding review pages, press coverage, or competitor mentions not on their own site.\\n**Example queries**:\\n- `\\\"[Competitor Name]\\\" site:g2.com`\\n- `\\\"[Competitor Name]\\\" review`\\n- `\\\"[Competitor Name]\\\" funding OR raised`\\n\\n### firecrawl_crawl\\n**Purpose**: Crawl multiple pages from a site in one operation.\\n**When to use**: Deep profiles where you want to analyze many pages (e.g., all feature pages, all blog posts). More expensive — use selectively.\\n**Tip**: Set page limits to avoid crawling entire sites. Target specific URL patterns.\\n\\n### firecrawl_extract\\n**Purpose**: Extract structured data from a page using a schema.\\n**When to use**: When you need specific data points in a consistent format (e.g., pricing tier details, feature lists).\\n**Tip**: Define a clear schema for what you want extracted — more reliable than parsing raw markdown.\\n\\n---\\n\\n## DataForSEO MCP Tools\\n\\n### Domain-Level Intelligence\\n\\n#### backlinks_summary\\n**Purpose**: Get domain authority, total backlinks, referring domains, spam score.\\n**Input**: Target domain (e.g., `competitor.com`)\\n**Key metrics**: `domain_rank`, `total_backlinks`, `referring_domains`, `backlinks_spam_score`\\n\\n#### backlinks_referring_domains\\n**Purpose**: List top referring domains — shows where their link equity comes from.\\n**Input**: Target domain + limit\\n**Key metrics**: Per-domain: `rank`, `backlinks`, `domain` name\\n\\n#### dataforseo_labs_google_domain_rank_overview\\n**Purpose**: Organic search overview — traffic, keywords, traffic value.\\n**Input**: Target domain\\n**Key metrics**: `organic_count` (keywords), `organic_traffic` (estimated monthly), `organic_cost` (traffic value in $)\\n\\n#### dataforseo_labs_google_ranked_keywords\\n**Purpose**: What keywords a domain ranks for, with positions.\\n**Input**: Target domain\\n**Key metrics**: Per-keyword: `keyword`, `position`, `search_volume`, `url` (ranking page)\\n**Tip**: Sort by traffic to find their highest-value keywords.\\n\\n#### dataforseo_labs_google_keywords_for_site\\n**Purpose**: Keywords relevant to a domain — broader than ranked keywords, includes opportunities.\\n**Input**: Target domain\\n**Key metrics**: `keyword`, `search_volume`, `competition`, `cpc`\\n\\n### Competitive Analysis\\n\\n#### dataforseo_labs_google_competitors_domain\\n**Purpose**: Find a domain's closest organic competitors by keyword overlap.\\n**Input**: Target domain\\n**Key metrics**: `domain`, `avg_position`, `intersections` (shared keywords), `full_domain_rank`\\n**Tip**: May reveal competitors the user hasn't considered.\\n\\n#### dataforseo_labs_google_domain_intersection\\n**Purpose**: Find keywords where two domains both rank — shows direct competition.\\n**Input**: Two target domains\\n**Key metrics**: `keyword`, position for each domain, `search_volume`\\n**Tip**: Use this to compare the user's domain vs. each competitor.\\n\\n#### dataforseo_labs_google_relevant_pages\\n**Purpose**: Find a domain's most important pages by organic traffic.\\n**Input**: Target domain\\n**Key metrics**: `page`, `metrics` (traffic, keywords per page)\\n**Tip**: Reveals their content strategy — which pages drive the most value.\\n\\n### Technology Detection\\n\\n#### domain_analytics_technologies_domain_technologies\\n**Purpose**: Detect the technology stack a domain uses.\\n**Input**: Target domain\\n**Key metrics**: Technologies grouped by category (CMS, analytics, marketing, payments, etc.)\\n\\n### Backlink Deep Dive\\n\\n#### backlinks_backlinks\\n**Purpose**: List individual backlinks to a domain.\\n**Input**: Target domain + limit\\n**Key metrics**: `url_from`, `url_to`, `anchor`, `domain_from_rank`, `is_new`\\n\\n#### backlinks_bulk_ranks\\n**Purpose**: Compare domain ranks across multiple domains at once.\\n**Input**: Array of target domains\\n**Key metrics**: `domain_rank` per domain\\n**Tip**: Use this for the summary comparison table.\\n\\n---\\n\\n## Recommended Execution Order\\n\\n### Quick Scan (per competitor)\\n\\n```\\n1. firecrawl_map → get site URLs\\n2. In parallel:\\n a. firecrawl_scrape → homepage\\n b. firecrawl_scrape → pricing page\\n c. dataforseo_labs_google_domain_rank_overview → organic metrics\\n d. backlinks_summary → domain authority\\n3. Synthesize into abbreviated profile\\n```\\n\\n### Deep Profile (per competitor)\\n\\n```\\n1. firecrawl_map → get site URLs\\n2. In parallel (batch 1 — scraping):\\n a. firecrawl_scrape → homepage\\n b. firecrawl_scrape → pricing page\\n c. firecrawl_scrape → features page(s)\\n d. firecrawl_scrape → about page\\n e. firecrawl_scrape → customers/case studies page\\n f. firecrawl_scrape → integrations page\\n3. In parallel (batch 2 — SEO data):\\n a. dataforseo_labs_google_domain_rank_overview\\n b. dataforseo_labs_google_ranked_keywords\\n c. backlinks_summary\\n d. backlinks_referring_domains\\n e. dataforseo_labs_google_relevant_pages\\n f. dataforseo_labs_google_competitors_domain\\n4. In parallel (batch 3 — optional extras):\\n a. domain_analytics_technologies_domain_technologies\\n b. firecrawl_search → G2/Capterra reviews\\n c. dataforseo_labs_google_domain_intersection (vs. user's domain)\\n5. Synthesize into full profile\\n```\\n\\n### Multi-Competitor (3+ competitors)\\n\\n```\\n1. Map all competitor sites in parallel\\n2. Scrape all homepages in parallel, then pricing pages in parallel\\n3. Pull domain_rank_overview for all in parallel\\n4. Pull backlinks_bulk_ranks for all at once\\n5. Build profiles in sequence (synthesis requires focus)\\n6. Build summary comparison last\\n```\\n\\n---\\n\\n## Error Handling\\n\\n| Issue | Action |\\n|-------|--------|\\n| Firecrawl scrape returns empty/blocked | Try with `firecrawl_browser_create` for JS-heavy sites |\\n| Pricing page not found in map | Search for `/pricing`, `/plans`, `/packages` — some sites use different paths |\\n| DataForSEO returns no data for domain | Domain may be too new or too small — note \\\"insufficient data\\\" in profile |\\n| Rate limits hit | Space out requests; prioritize highest-value data first |\\n| Review page scraping blocked | Use `firecrawl_search` to find cached or alternative review sources |\\n\"},\n {\"skill\":\"competitors\",\"ref\":\"content-architecture\",\"body\":\"# Content Architecture for Competitor Pages\\n\\nHow to structure and maintain competitor data for scalable comparison pages.\\n\\n## Contents\\n- Centralized Competitor Data\\n- Competitor Data Template\\n- Your Product Data\\n- Page Generation\\n- Index Page Structure (alternatives index, vs comparisons index, index page best practices)\\n- Footer Navigation\\n\\n## Centralized Competitor Data\\n\\nCreate a single source of truth for each competitor:\\n\\n```\\ncompetitor_data/\\n├── notion.md\\n├── airtable.md\\n├── monday.md\\n└── ...\\n```\\n\\n---\\n\\n## Competitor Data Template\\n\\nPer competitor, document:\\n\\n```yaml\\nname: Notion\\nwebsite: notion.so\\ntagline: \\\"The all-in-one workspace\\\"\\nfounded: 2016\\nheadquarters: San Francisco\\n\\n# Positioning\\nprimary_use_case: \\\"docs + light databases\\\"\\ntarget_audience: \\\"teams wanting flexible workspace\\\"\\nmarket_position: \\\"premium, feature-rich\\\"\\n\\n# Pricing\\npricing_model: per-seat\\nfree_tier: true\\nfree_tier_limits: \\\"limited blocks, 1 user\\\"\\nstarter_price: $8/user/month\\nbusiness_price: $15/user/month\\nenterprise: custom\\n\\n# Features (rate 1-5 or describe)\\nfeatures:\\n documents: 5\\n databases: 4\\n project_management: 3\\n collaboration: 4\\n integrations: 3\\n mobile_app: 3\\n offline_mode: 2\\n api: 4\\n\\n# Strengths (be honest)\\nstrengths:\\n - Extremely flexible and customizable\\n - Beautiful, modern interface\\n - Strong template ecosystem\\n - Active community\\n\\n# Weaknesses (be fair)\\nweaknesses:\\n - Can be slow with large databases\\n - Learning curve for advanced features\\n - Limited automations compared to dedicated tools\\n - Offline mode is limited\\n\\n# Best for\\nbest_for:\\n - Teams wanting all-in-one workspace\\n - Content-heavy workflows\\n - Documentation-first teams\\n - Startups and small teams\\n\\n# Not ideal for\\nnot_ideal_for:\\n - Complex project management needs\\n - Large databases (1000s of rows)\\n - Teams needing robust offline\\n - Enterprise with strict compliance\\n\\n# Common complaints (from reviews)\\ncommon_complaints:\\n - \\\"Gets slow with lots of content\\\"\\n - \\\"Hard to find things as workspace grows\\\"\\n - \\\"Mobile app is clunky\\\"\\n\\n# Migration notes\\nmigration_from:\\n difficulty: medium\\n data_export: \\\"Markdown, CSV, HTML\\\"\\n what_transfers: \\\"Pages, databases\\\"\\n what_doesnt: \\\"Automations, integrations setup\\\"\\n time_estimate: \\\"1-3 days for small team\\\"\\n```\\n\\n---\\n\\n## Your Product Data\\n\\nSame structure for yourself—be honest:\\n\\n```yaml\\nname: [Your Product]\\n# ... same fields\\n\\nstrengths:\\n - [Your real strengths]\\n\\nweaknesses:\\n - [Your honest weaknesses]\\n\\nbest_for:\\n - [Your ideal customers]\\n\\nnot_ideal_for:\\n - [Who should use something else]\\n```\\n\\n---\\n\\n## Page Generation\\n\\nEach page pulls from centralized data:\\n\\n- **[Competitor] Alternative page**: Pulls competitor data + your data\\n- **[Competitor] Alternatives page**: Pulls competitor data + your data + other alternatives\\n- **You vs [Competitor] page**: Pulls your data + competitor data\\n- **[A] vs [B] page**: Pulls both competitor data + your data\\n\\n**Benefits**:\\n- Update competitor pricing once, updates everywhere\\n- Add new feature comparison once, appears on all pages\\n- Consistent accuracy across pages\\n- Easier to maintain at scale\\n\\n---\\n\\n## Index Page Structure\\n\\n### Alternatives Index\\n\\n**URL**: `/alternatives` or `/alternatives/index`\\n\\n**Purpose**: Lists all \\\"[Competitor] Alternative\\\" pages\\n\\n**Page structure**:\\n1. Headline: \\\"[Your Product] as an Alternative\\\"\\n2. Brief intro on why people switch to you\\n3. List of all alternative pages with:\\n - Competitor name/logo\\n - One-line summary of key differentiator vs. that competitor\\n - Link to full comparison\\n4. Common reasons people switch (aggregated)\\n5. CTA\\n\\n**Example**:\\n```markdown\\n## Explore [Your Product] as an Alternative\\n\\nLooking to switch? See how [Your Product] compares to the tools you're evaluating:\\n\\n- **[Notion Alternative](/alternatives/notion)** — Better for teams who need [X]\\n- **[Airtable Alternative](/alternatives/airtable)** — Better for teams who need [Y]\\n- **[Monday Alternative](/alternatives/monday)** — Better for teams who need [Z]\\n```\\n\\n---\\n\\n### Vs Comparisons Index\\n\\n**URL**: `/vs` or `/compare`\\n\\n**Purpose**: Lists all \\\"You vs [Competitor]\\\" and \\\"[A] vs [B]\\\" pages\\n\\n**Page structure**:\\n1. Headline: \\\"Compare [Your Product]\\\"\\n2. Section: \\\"[Your Product] vs Competitors\\\" — list of direct comparisons\\n3. Section: \\\"Head-to-Head Comparisons\\\" — list of [A] vs [B] pages\\n4. Brief methodology note\\n5. CTA\\n\\n---\\n\\n### Index Page Best Practices\\n\\n**Keep them updated**: When you add a new comparison page, add it to the relevant index.\\n\\n**Internal linking**:\\n- Link from index → individual pages\\n- Link from individual pages → back to index\\n- Cross-link between related comparisons\\n\\n**SEO value**:\\n- Index pages can rank for broad terms like \\\"project management tool comparisons\\\"\\n- Pass link equity to individual comparison pages\\n- Help search engines discover all comparison content\\n\\n**Sorting options**:\\n- By popularity (search volume)\\n- Alphabetically\\n- By category/use case\\n- By date added (show freshness)\\n\\n**Include on index pages**:\\n- Last updated date for credibility\\n- Number of pages/comparisons available\\n- Quick filters if you have many comparisons\\n\\n---\\n\\n## Footer Navigation\\n\\nThe site footer appears on all marketing pages, making it a powerful internal linking opportunity for competitor pages.\\n\\n### Option 1: Link to Index Pages (Minimum)\\n\\nAt minimum, add links to your comparison index pages in the footer:\\n\\n```\\nFooter\\n├── Compare\\n│ ├── Alternatives → /alternatives\\n│ └── Comparisons → /vs\\n```\\n\\nThis ensures every marketing page passes link equity to your comparison content hub.\\n\\n### Option 2: Footer Columns by Format (Recommended for SEO)\\n\\nFor stronger internal linking, create dedicated footer columns for each format you've built, linking directly to your top competitors:\\n\\n```\\nFooter\\n├── [Product] vs ├── Alternatives to ├── Compare\\n│ ├── vs Notion │ ├── Notion Alternative │ ├── Notion vs Airtable\\n│ ├── vs Airtable │ ├── Airtable Alternative │ ├── Monday vs Asana\\n│ ├── vs Monday │ ├── Monday Alternative │ ├── Notion vs Monday\\n│ ├── vs Asana │ ├── Asana Alternative │ ├── ...\\n│ ├── vs Clickup │ ├── Clickup Alternative │ └── View all →\\n│ ├── ... │ ├── ... │\\n│ └── View all → │ └── View all → │\\n```\\n\\n**Guidelines**:\\n- Include up to 8 links per column (top competitors by search volume)\\n- Add \\\"View all\\\" link to the full index page\\n- Only create columns for formats you've actually built pages for\\n- Prioritize competitors with highest search volume\\n\\n### Why Footer Links Matter\\n\\n1. **Sitewide distribution**: Footer links appear on every marketing page, passing link equity from your entire site to comparison content\\n2. **Crawl efficiency**: Search engines discover all comparison pages quickly\\n3. **User discovery**: Visitors evaluating your product can easily find comparisons\\n4. **Competitive positioning**: Signals to search engines that you're a key player in the space\\n\\n### Implementation Notes\\n\\n- Update footer when adding new high-priority comparison pages\\n- Keep footer clean—don't list every comparison, just the top ones\\n- Match column headers to your URL structure (e.g., \\\"vs\\\" column → `/vs/` URLs)\\n- Consider mobile: columns may stack, so order by priority\\n\"},\n {\"skill\":\"competitors\",\"ref\":\"templates\",\"body\":\"# Section Templates for Competitor Pages\\n\\nReady-to-use templates for each section of competitor comparison pages.\\n\\n## Contents\\n- TL;DR Summary\\n- Paragraph Comparison (Not Just Tables)\\n- Feature Comparison Section\\n- Pricing Comparison Section\\n- Service & Support Comparison\\n- Who It's For Section\\n- Migration Section\\n- Social Proof Section\\n- Comparison Table Best Practices (beyond checkmarks, organize by category, include ratings where useful)\\n\\n## TL;DR Summary\\n\\nStart every page with a quick summary for scanners:\\n\\n```markdown\\n**TL;DR**: [Competitor] excels at [strength] but struggles with [weakness].\\n[Your product] is built for [your focus], offering [key differentiator].\\nChoose [Competitor] if [their ideal use case]. Choose [You] if [your ideal use case].\\n```\\n\\n---\\n\\n## Paragraph Comparison (Not Just Tables)\\n\\nFor each major dimension, write a paragraph:\\n\\n```markdown\\n## Features\\n\\n[Competitor] offers [description of their feature approach].\\nTheir strength is [specific strength], which works well for [use case].\\nHowever, [limitation] can be challenging for [user type].\\n\\n[Your product] takes a different approach with [your approach].\\nThis means [benefit], though [honest tradeoff].\\nTeams who [specific need] often find this more effective.\\n```\\n\\n---\\n\\n## Feature Comparison Section\\n\\nGo beyond checkmarks:\\n\\n```markdown\\n## Feature Comparison\\n\\n### [Feature Category]\\n\\n**[Competitor]**: [2-3 sentence description of how they handle this]\\n- Strengths: [specific]\\n- Limitations: [specific]\\n\\n**[Your product]**: [2-3 sentence description]\\n- Strengths: [specific]\\n- Limitations: [specific]\\n\\n**Bottom line**: Choose [Competitor] if [scenario]. Choose [You] if [scenario].\\n```\\n\\n---\\n\\n## Pricing Comparison Section\\n\\n```markdown\\n## Pricing\\n\\n| | [Competitor] | [Your Product] |\\n|---|---|---|\\n| Free tier | [Details] | [Details] |\\n| Starting price | $X/user/mo | $X/user/mo |\\n| Business tier | $X/user/mo | $X/user/mo |\\n| Enterprise | Custom | Custom |\\n\\n**What's included**: [Competitor]'s $X plan includes [features], while\\n[Your product]'s $X plan includes [features].\\n\\n**Total cost consideration**: Beyond per-seat pricing, consider [hidden costs,\\nadd-ons, implementation]. [Competitor] charges extra for [X], while\\n[Your product] includes [Y] in base pricing.\\n\\n**Value comparison**: For a 10-person team, [Competitor] costs approximately\\n$X/year while [Your product] costs $Y/year, with [key differences in what you get].\\n```\\n\\n---\\n\\n## Service & Support Comparison\\n\\n```markdown\\n## Service & Support\\n\\n| | [Competitor] | [Your Product] |\\n|---|---|---|\\n| Documentation | [Quality assessment] | [Quality assessment] |\\n| Response time | [SLA if known] | [Your SLA] |\\n| Support channels | [List] | [List] |\\n| Onboarding | [What they offer] | [What you offer] |\\n| CSM included | [At what tier] | [At what tier] |\\n\\n**Support quality**: Based on [G2/Capterra reviews, your research],\\n[Competitor] support is described as [assessment]. Common feedback includes\\n[quotes or themes].\\n\\n[Your product] offers [your support approach]. [Specific differentiator like\\nresponse time, dedicated CSM, implementation help].\\n```\\n\\n---\\n\\n## Who It's For Section\\n\\n```markdown\\n## Who Should Choose [Competitor]\\n\\n[Competitor] is the right choice if:\\n- [Specific use case or need]\\n- [Team type or size]\\n- [Workflow or requirement]\\n- [Budget or priority]\\n\\n**Ideal [Competitor] customer**: [Persona description in 1-2 sentences]\\n\\n## Who Should Choose [Your Product]\\n\\n[Your product] is built for teams who:\\n- [Specific use case or need]\\n- [Team type or size]\\n- [Workflow or requirement]\\n- [Priority or value]\\n\\n**Ideal [Your product] customer**: [Persona description in 1-2 sentences]\\n```\\n\\n---\\n\\n## Migration Section\\n\\n```markdown\\n## Switching from [Competitor]\\n\\n### What transfers\\n- [Data type]: [How easily, any caveats]\\n- [Data type]: [How easily, any caveats]\\n\\n### What needs reconfiguration\\n- [Thing]: [Why and effort level]\\n- [Thing]: [Why and effort level]\\n\\n### Migration support\\n\\nWe offer [migration support details]:\\n- [Free data import tool / white-glove migration]\\n- [Documentation / migration guide]\\n- [Timeline expectation]\\n- [Support during transition]\\n\\n### What customers say about switching\\n\\n> \\\"[Quote from customer who switched]\\\"\\n> — [Name], [Role] at [Company]\\n```\\n\\n---\\n\\n## Social Proof Section\\n\\nFocus on switchers:\\n\\n```markdown\\n## What Customers Say\\n\\n### Switched from [Competitor]\\n\\n> \\\"[Specific quote about why they switched and outcome]\\\"\\n> — [Name], [Role] at [Company]\\n\\n> \\\"[Another quote]\\\"\\n> — [Name], [Role] at [Company]\\n\\n### Results after switching\\n- [Company] saw [specific result]\\n- [Company] reduced [metric] by [amount]\\n```\\n\\n---\\n\\n## Comparison Table Best Practices\\n\\n### Beyond Checkmarks\\n\\nInstead of:\\n| Feature | You | Competitor |\\n|---------|-----|-----------|\\n| Feature A | ✓ | ✓ |\\n| Feature B | ✓ | ✗ |\\n\\nDo this:\\n| Feature | You | Competitor |\\n|---------|-----|-----------|\\n| Feature A | Full support with [detail] | Basic support, [limitation] |\\n| Feature B | [Specific capability] | Not available |\\n\\n### Organize by Category\\n\\nGroup features into meaningful categories:\\n- Core functionality\\n- Collaboration\\n- Integrations\\n- Security & compliance\\n- Support & service\\n\\n### Include Ratings Where Useful\\n\\n| Category | You | Competitor | Notes |\\n|----------|-----|-----------|-------|\\n| Ease of use | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | [Brief note] |\\n| Feature depth | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | [Brief note] |\\n\"}\n];\n",[],[463,774,808],"fa59002a-5d6d-11f1-9770-1607ee4eb77e","ref_3.ts","fa5900e8-5d6d-11f1-9770-1607ee4eb77e",662,["D",1780286235804],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_3: SkillRef[] = [\n {\"skill\":\"analytics\",\"ref\":\"gtm-implementation\",\"body\":\"# Google Tag Manager Implementation Reference\\n\\nDetailed guide for implementing tracking via Google Tag Manager.\\n\\n## Contents\\n- Container Structure (tags, triggers, variables)\\n- Naming Conventions\\n- Data Layer Patterns\\n- Common Tag Configurations (GA4 configuration tag, GA4 event tag, Facebook pixel)\\n- Preview and Debug\\n- Workspaces and Versioning\\n- Consent Management\\n- Advanced Patterns (tag sequencing, exception handling, custom JavaScript variables)\\n\\n## Container Structure\\n\\n### Tags\\n\\nTags are code snippets that execute when triggered.\\n\\n**Common tag types:**\\n- GA4 Configuration (base setup)\\n- GA4 Event (custom events)\\n- Google Ads Conversion\\n- Facebook Pixel\\n- LinkedIn Insight Tag\\n- Custom HTML (for other pixels)\\n\\n### Triggers\\n\\nTriggers define when tags fire.\\n\\n**Built-in triggers:**\\n- Page View: All Pages, DOM Ready, Window Loaded\\n- Click: All Elements, Just Links\\n- Form Submission\\n- Scroll Depth\\n- Timer\\n- Element Visibility\\n\\n**Custom triggers:**\\n- Custom Event (from dataLayer)\\n- Trigger Groups (multiple conditions)\\n\\n### Variables\\n\\nVariables capture dynamic values.\\n\\n**Built-in (enable as needed):**\\n- Click Text, Click URL, Click ID, Click Classes\\n- Page Path, Page URL, Page Hostname\\n- Referrer\\n- Form Element, Form ID\\n\\n**User-defined:**\\n- Data Layer variables\\n- JavaScript variables\\n- Lookup tables\\n- RegEx tables\\n- Constants\\n\\n---\\n\\n## Naming Conventions\\n\\n### Recommended Format\\n\\n```\\n[Type] - [Description] - [Detail]\\n\\nTags:\\nGA4 - Event - Signup Completed\\nGA4 - Config - Base Configuration\\nFB - Pixel - Page View\\nHTML - LiveChat Widget\\n\\nTriggers:\\nClick - CTA Button\\nSubmit - Contact Form\\nView - Pricing Page\\nCustom - signup_completed\\n\\nVariables:\\nDL - user_id\\nJS - Current Timestamp\\nLT - Campaign Source Map\\n```\\n\\n---\\n\\n## Data Layer Patterns\\n\\n### Basic Structure\\n\\n```javascript\\n// Initialize (in before GTM)\\nwindow.dataLayer = window.dataLayer || [];\\n\\n// Push event\\ndataLayer.push({\\n 'event': 'event_name',\\n 'property1': 'value1',\\n 'property2': 'value2'\\n});\\n```\\n\\n### Page Load Data\\n\\n```javascript\\n// Set on page load (before GTM container)\\nwindow.dataLayer = window.dataLayer || [];\\ndataLayer.push({\\n 'pageType': 'product',\\n 'contentGroup': 'products',\\n 'user': {\\n 'loggedIn': true,\\n 'userId': '12345',\\n 'userType': 'premium'\\n }\\n});\\n```\\n\\n### Form Submission\\n\\n```javascript\\ndocument.querySelector('#contact-form').addEventListener('submit', function() {\\n dataLayer.push({\\n 'event': 'form_submitted',\\n 'formName': 'contact',\\n 'formLocation': 'footer'\\n });\\n});\\n```\\n\\n### Button Click\\n\\n```javascript\\ndocument.querySelector('.cta-button').addEventListener('click', function() {\\n dataLayer.push({\\n 'event': 'cta_clicked',\\n 'ctaText': this.innerText,\\n 'ctaLocation': 'hero'\\n });\\n});\\n```\\n\\n### E-commerce Events\\n\\n```javascript\\n// Product view\\ndataLayer.push({ ecommerce: null }); // Clear previous\\ndataLayer.push({\\n 'event': 'view_item',\\n 'ecommerce': {\\n 'items': [{\\n 'item_id': 'SKU123',\\n 'item_name': 'Product Name',\\n 'price': 99.99,\\n 'item_category': 'Category',\\n 'quantity': 1\\n }]\\n }\\n});\\n\\n// Add to cart\\ndataLayer.push({ ecommerce: null });\\ndataLayer.push({\\n 'event': 'add_to_cart',\\n 'ecommerce': {\\n 'items': [{\\n 'item_id': 'SKU123',\\n 'item_name': 'Product Name',\\n 'price': 99.99,\\n 'quantity': 1\\n }]\\n }\\n});\\n\\n// Purchase\\ndataLayer.push({ ecommerce: null });\\ndataLayer.push({\\n 'event': 'purchase',\\n 'ecommerce': {\\n 'transaction_id': 'T12345',\\n 'value': 99.99,\\n 'currency': 'USD',\\n 'tax': 5.00,\\n 'shipping': 10.00,\\n 'items': [{\\n 'item_id': 'SKU123',\\n 'item_name': 'Product Name',\\n 'price': 99.99,\\n 'quantity': 1\\n }]\\n }\\n});\\n```\\n\\n---\\n\\n## Common Tag Configurations\\n\\n### GA4 Configuration Tag\\n\\n**Tag Type:** Google Analytics: GA4 Configuration\\n\\n**Settings:**\\n- Measurement ID: G-XXXXXXXX\\n- Send page view: Checked (for pageviews)\\n- User Properties: Add any user-level dimensions\\n\\n**Trigger:** All Pages\\n\\n### GA4 Event Tag\\n\\n**Tag Type:** Google Analytics: GA4 Event\\n\\n**Settings:**\\n- Configuration Tag: Select your config tag\\n- Event Name: {{DL - event_name}} or hardcode\\n- Event Parameters: Add parameters from dataLayer\\n\\n**Trigger:** Custom Event with event name match\\n\\n### Facebook Pixel - Base\\n\\n**Tag Type:** Custom HTML\\n\\n```html\\n\\n```\\n\\n**Trigger:** All Pages\\n\\n### Facebook Pixel - Event\\n\\n**Tag Type:** Custom HTML\\n\\n```html\\n\\n```\\n\\n**Trigger:** Custom Event - form_submitted\\n\\n---\\n\\n## Preview and Debug\\n\\n### Preview Mode\\n\\n1. Click \\\"Preview\\\" in GTM\\n2. Enter site URL\\n3. GTM debug panel opens at bottom\\n\\n**What to check:**\\n- Tags fired on this event\\n- Tags not fired (and why)\\n- Variables and their values\\n- Data layer contents\\n\\n### Debug Tips\\n\\n**Tag not firing:**\\n- Check trigger conditions\\n- Verify data layer push\\n- Check tag sequencing\\n\\n**Wrong variable value:**\\n- Check data layer structure\\n- Verify variable path (nested objects)\\n- Check timing (data may not exist yet)\\n\\n**Multiple firings:**\\n- Check trigger uniqueness\\n- Look for duplicate tags\\n- Check tag firing options\\n\\n---\\n\\n## Workspaces and Versioning\\n\\n### Workspaces\\n\\nUse workspaces for team collaboration:\\n- Default workspace for production\\n- Separate workspaces for large changes\\n- Merge when ready\\n\\n### Version Management\\n\\n**Best practices:**\\n- Name every version descriptively\\n- Add notes explaining changes\\n- Review changes before publish\\n- Keep production version noted\\n\\n**Version notes example:**\\n```\\nv15: Added purchase conversion tracking\\n- New tag: GA4 - Event - Purchase\\n- New trigger: Custom Event - purchase\\n- New variables: DL - transaction_id, DL - value\\n- Tested: Chrome, Safari, Mobile\\n```\\n\\n---\\n\\n## Consent Management\\n\\n### Consent Mode Integration\\n\\n```javascript\\n// Default state (before consent)\\ngtag('consent', 'default', {\\n 'analytics_storage': 'denied',\\n 'ad_storage': 'denied'\\n});\\n\\n// Update on consent\\nfunction grantConsent() {\\n gtag('consent', 'update', {\\n 'analytics_storage': 'granted',\\n 'ad_storage': 'granted'\\n });\\n}\\n```\\n\\n### GTM Consent Overview\\n\\n1. Enable Consent Overview in Admin\\n2. Configure consent for each tag\\n3. Tags respect consent state automatically\\n\\n---\\n\\n## Advanced Patterns\\n\\n### Tag Sequencing\\n\\n**Setup tags to fire in order:**\\nTag Configuration > Advanced Settings > Tag Sequencing\\n\\n**Use cases:**\\n- Config tag before event tags\\n- Pixel initialization before tracking\\n- Cleanup after conversion\\n\\n### Exception Handling\\n\\n**Trigger exceptions** - Prevent tag from firing:\\n- Exclude certain pages\\n- Exclude internal traffic\\n- Exclude during testing\\n\\n### Custom JavaScript Variables\\n\\n```javascript\\n// Get URL parameter\\nfunction() {\\n var params = new URLSearchParams(window.location.search);\\n return params.get('campaign') || '(not set)';\\n}\\n\\n// Get cookie value\\nfunction() {\\n var match = document.cookie.match('(^|;) ?user_id=([^;]*)(;|$)');\\n return match ? match[2] : null;\\n}\\n\\n// Get data from page\\nfunction() {\\n var el = document.querySelector('.product-price');\\n return el ? parseFloat(el.textContent.replace('$', '')) : 0;\\n}\\n```\\n\"},\n {\"skill\":\"aso\",\"ref\":\"apple-specs\",\"body\":\"# Apple App Store — Official Specs & Guidelines\\n\\nAll data from developer.apple.com as of March 2026.\\n\\n## Character Limits\\n\\n| Field | Limit | Indexed for Search? | Notes |\\n| ----------------------- | ---------------- | ------------------------ | -------------------------------------------------------- |\\n| App Name | 30 chars (min 2) | Yes | Must be unique; no trademarks, competitor names, pricing |\\n| Subtitle | 30 chars | Yes | No unverifiable claims |\\n| Keywords | 100 bytes | Yes (hidden) | Commas, no spaces between terms |\\n| Description | 4,000 chars | **No** | Plain text only, no HTML |\\n| Promotional Text | 170 chars | **No** (Apple confirmed) | Updatable without new version |\\n| What's New | 4,000 chars | No | Required for all versions after first |\\n| IAP Name | 35 chars | Yes | Appears in search |\\n| IAP Description | 55 chars | No | |\\n| In-App Event Name | 30 chars | Yes | Title case required |\\n| In-App Event Short Desc | 50 chars | Yes | Sentence case |\\n| In-App Event Long Desc | 120 chars | No | Sentence case |\\n\\n**Keywords field is 100 bytes, not 100 characters.** Non-Latin scripts (Arabic,\\nChinese, Japanese, Korean) use 2-3 bytes per character, reducing effective\\nkeyword count significantly.\\n\\n## Screenshot Specs\\n\\n| Device | Required? | Count | Dimensions (portrait) |\\n| ---------------- | ------------- | ----- | -------------------------- |\\n| 6.9\\\" iPhone | **Required** | 1-10 | 1260 x 2736 |\\n| 13\\\" iPad | **Required** | 1-10 | 2064 x 2752 |\\n| Mac | If applicable | 1-10 | Up to 2880 x 1800 (16:10) |\\n| Apple Watch | If applicable | 1-10 | Varies by model |\\n| Apple TV | If applicable | 1-10 | 1920 x 1080 or 3840 x 2160 |\\n| Apple Vision Pro | If applicable | 1-10 | 3840 x 2160 |\\n\\n- Formats: JPEG, PNG\\n- Apple auto-scales from required base sizes to smaller devices\\n\\n## App Preview Video Specs\\n\\n- **Count:** Up to 3 per app\\n- **Duration:** 15-30 seconds\\n- **Max file size:** 500 MB\\n- **Codecs:** H.264 (10-12 Mbps, up to 30fps) or ProRes 422 HQ\\n- **Audio:** Stereo, 256 kbps AAC or PCM, 44.1/48 kHz\\n- **Formats:** .mov, .m4v, .mp4\\n- **Behavior:** Autoplays muted on product page (iOS 11+)\\n\\n## Custom Product Pages (CPPs)\\n\\n- **Max:** 70 additional pages (plus 1 default)\\n- **Customizable:** Screenshots, promotional text, app previews, deep links (iOS 18+)\\n- **Keywords:** Each keyword combo must be unique to a single CPP\\n- **Review:** Submitted to App Review independently of app updates\\n- **Organic search:** CPPs appear in organic search results since July 2025\\n- **Performance:** +2.5 percentage points higher conversion on average vs default\\n\\n## Product Page Optimization (A/B Testing)\\n\\n- **Treatments:** Up to 3 vs original\\n- **Testable:** App icons, screenshots, app preview videos\\n- **NOT testable:** Title, subtitle, description, keywords\\n- **Concurrent tests:** 1 per app\\n- **Max duration:** 90 days\\n- **Icon constraint:** All icon variants must be in the published app binary\\n- **Confidence:** Apple recommends 90% threshold (Bayesian method)\\n- **Cannot modify** a test once started\\n\\n## In-App Events\\n\\n- **Max approved:** 15 in App Store Connect at once\\n- **Max published:** 10 on App Store simultaneously\\n- **Max duration:** 31 days per event\\n- **Pre-event promotion:** Up to 14 days before start\\n- **Badge types:** Challenge, Competition, Live Event, Major Update, New Season, Premiere, Special Event\\n\\n**Event card image:** 16:9, min 1920x1080, max 3840x2160\\n**Event details image:** 9:16, min 1080x1920, max 2160x3840\\n\\n**Not suitable:** Repetitive daily tasks, price promotions without new content, general awareness campaigns.\\n\\n## Ratings & Reviews\\n\\n- **SKStoreReviewController:** Max 3 prompts per 365-day period\\n- System controls display frequency (may show fewer than 3)\\n- Do not use custom buttons to request reviews\\n- Developers can respond to all reviews in App Store Connect\\n- Summary rating is territory-specific\\n\\n## Metadata Rejection Triggers (App Review Guidelines)\\n\\n| Guideline | Rejection Trigger |\\n| --------- | ------------------------------------------------------------------------- |\\n| 2.3.1 | Hidden features, misleading marketing, false pricing |\\n| 2.3.2 | Not disclosing IAPs in description/screenshots |\\n| 2.3.3 | Screenshots that don't show app in use (only splash/login) |\\n| 2.3.4 | Preview videos using non-app content |\\n| 2.3.5 | Wrong category selected |\\n| 2.3.7 | Keyword stuffing: trademarks, competitor names, pricing, irrelevant terms |\\n| 2.3.8 | Metadata not appropriate for all audiences (must be 4+ rated) |\\n| 2.3.10 | Other platform names/imagery (Android, etc.) in metadata |\\n| 2.3.12 | Generic What's New for significant changes |\\n| 2.3.13 | Inaccurate in-app event metadata |\\n\\nSources: developer.apple.com/app-store/product-page/,\\ndeveloper.apple.com/app-store/search/,\\ndeveloper.apple.com/app-store/review/guidelines/\\n\"},\n {\"skill\":\"aso\",\"ref\":\"benchmarks\",\"body\":\"# ASO Benchmarks & Conversion Data\\n\\nIndustry data from AppTweak, SplitMetrics, Sensor Tower, and others. Updated March 2026.\\n\\n## Conversion Rate Benchmarks by Category\\n\\n**Average CVR (page view to install):**\\n\\n- iOS overall: **25.0%**\\n- Google Play overall: **27.3%**\\n\\n| Category | iOS CVR | Google Play CVR |\\n| ----------------- | -------------- | --------------- |\\n| Navigation | 115%\\\\* | -- |\\n| Auto & Vehicles | -- | 70.5% |\\n| Business | 66.7% | -- |\\n| Music (Games) | -- | 45.0% |\\n| Utilities & Tools | -- | 36.8% |\\n| Shopping | -- | 27.7% |\\n| Health & Fitness | -- | 23.2% |\\n| Finance | -- | 19.7% |\\n| Food & Drink | -- | 13.1% |\\n| Games (Board) | 1.2% | 7.3% |\\n| Games (overall) | 3-5% realistic | -- |\\n\\n\\\\*Above 100% = some users install from search without visiting product page.\\n\\nSource: AppTweak 2025 Benchmarks Report (H1 2024 data, US market)\\n\\n## Rating Impact on Conversion\\n\\n| Rating Change | Conversion Impact |\\n| -------------------------- | --------------------------------------- |\\n| 3.0 to 4.0 stars | **+89%** |\\n| 4.0 to 4.5 stars | **+20-30%** |\\n| 4.3 to 4.6 stars | **+22-28%** (Finance, Health) |\\n| 0.4-star gap vs competitor | **~25% lost installs** from same search |\\n| 3-star vs 5-star app | **50% fewer conversions** for 3-star |\\n\\n**Critical thresholds:**\\n\\n- **4.0 stars** = minimum for Apple featuring, user trust, conversion viability\\n- **4.5+ stars** = optimal zone. Sweet spot: 4.1-4.9\\n- **5.0 stars** can look suspicious to users\\n- **Below 3.5** = sharp visibility drop on both stores\\n- **79% of users** check ratings before downloading\\n- **50% reject** apps below 3 stars\\n\\nSources: AppFollow, MobileAction, Sensor Tower, Troof.ai\\n\\n## Preview Video Impact\\n\\n**iOS:** +20-40% conversion lift (video autoplays on product page)\\n**Google Play:** Minimal lift (only ~6% of visitors tap to play)\\n\\n- Autoplay introduced in iOS 11 caused **+47% conversion jump**\\n- Users who watch video are **2x more likely to install**\\n- Average watch time: **4-6.5 seconds** (first 5 seconds are critical)\\n- 50%+ of viewers watch to the end\\n\\n**Takeaway:** Video is high-ROI on iOS, low-ROI on Google Play.\\n\\nSources: StoreMaven, SplitMetrics, Leanplum\\n\\n## Screenshot Impact\\n\\n- **90% of users** do not scroll past the 3rd screenshot\\n- Average scroll rate: only **17%**\\n- Users spend **6-10 seconds** scanning before deciding\\n- **First screenshot decides everything**\\n- Well-designed screenshots lift conversion **20-35%**\\n- A/B test winners see **10-25% improvement**\\n- **Optimal count:** 4-5 for utility apps, 5-6 for complex apps\\n- More than 6: diminishing returns, can cause decision paralysis\\n- Top 200 apps update screenshots **2-4 times/year**\\n- Top Google Play games update visuals **up to 8x/year**\\n- **57% of top games** A/B tested screenshots at least 2x in 2024\\n\\nSources: AppTweak, ASOMobile, Sensor Tower\\n\\n## Custom Product Pages (Apple CPPs)\\n\\n- Average conversion lift: **+5.9% for apps**, **+3.5% for games**\\n- Best cases: up to **+8.6%**\\n- Organic referral: **+2.5 percentage points** (156% lift vs 1.6% baseline)\\n- Apple Ads CPP CVR: **55.8% in 2024** (up from 42.1% in 2023)\\n- **Only 31% of apps** and **26% of games** use CPPs (low adoption = opportunity)\\n- Screenshot reordering alone produced **+16.6% installs** in one case\\n\\nSources: AppTweak, SplitMetrics, MobileAction\\n\\n## Custom Store Listings (Google Play CSLs)\\n\\n- Up to **50 custom versions** per app\\n- Case study (Lockwood/Avakin Life): **+57% CVR** over 2 months\\n- Can target inactive/churned users (28+ days no activity)\\n\\nSource: Phiture, MobileAction\\n\\n## In-App Events (Apple)\\n\\n- **55% of top 200 apps** use them regularly\\n- +**15-20% more impressions** from editorial/browse placements\\n- One case: **+124% surge** in total impressions\\n- One case: **+50% impressions AND first-time downloads**\\n- Search CVR uptick: **+10.3%**\\n- Re-downloads increase: **+15.5%**\\n- **Boost is short-lived** -- KPIs drop to baseline when event ends\\n- Optimal: **2-4 active events per month**\\n\\nSources: Phiture, AppTweak, Appalize\\n\\n## Promotional Content (Google Play)\\n\\n- Apps with featuring see **2x explore acquisitions** (official Google)\\n- +2% 28-day active users and +4% revenue on average\\n\\nSource: Google Play Console documentation\\n\\n## A/B Test Impact Thresholds\\n\\n| Improvement | Classification |\\n| ----------- | ---------------------------------- |\\n| >10% | Strong winner -- apply immediately |\\n| 5-10% | Meaningful winner |\\n| 2-5% | Marginal winner |\\n| <2% | Noise -- not significant |\\n\\nSource: SplitMetrics, MobileAction\\n\"},\n {\"skill\":\"aso\",\"ref\":\"google-play-specs\",\"body\":\"# Google Play Store — Official Specs & Guidelines\\n\\nAll data from support.google.com and developer.android.com as of March 2026.\\n\\n## Character Limits\\n\\n| Field | Limit | Indexed? | Notes |\\n| ----------------- | ----------- | ---------------------- | ------------------------------------- |\\n| App Title | 30 chars | Yes (strongest signal) | Reduced from 50 in Sept 2021 |\\n| Short Description | 80 chars | Yes | Visible without expanding |\\n| Full Description | 4,000 chars | **Yes (heavily)** | Google NLP indexes entire text |\\n| Developer Name | 64 chars | Partial | Same emoji/caps restrictions as title |\\n\\n## Prohibited in Metadata (enforced since Sept 2021)\\n\\n**Title, Icon, Developer Name:**\\n\\n- Emojis, emoticons, repeated special characters\\n- ALL CAPS (unless registered brand)\\n- Performance claims: \\\"top,\\\" \\\"best,\\\" \\\"#1,\\\" \\\"free,\\\" \\\"no ads\\\"\\n- Misleading store performance or endorsement\\n- Calls-to-action: \\\"update now,\\\" \\\"download now\\\"\\n\\n**Short Description:**\\n\\n- Same performance claims as title\\n- Calls-to-action\\n- Unattributed testimonials\\n\\n**Screenshots, Feature Graphic, Video:**\\n\\n- Time-sensitive taglines\\n- Calls-to-action (\\\"Download now,\\\" \\\"Play now\\\")\\n- Must authentically showcase app functionality\\n\\n## Screenshot Specs\\n\\n| Device | Min | Max | Aspect Ratio | Min Resolution | Max Long Edge |\\n| ---------- | ----- | ----- | ------------ | -------------- | ------------- |\\n| Phone | **2** | **8** | 9:16 or 16:9 | 320px any side | 3,840px |\\n| 7\\\" Tablet | 4 | 8 | 9:16 or 16:9 | 1,080px short | 7,680px |\\n| 10\\\" Tablet | 4 | 8 | 9:16 or 16:9 | 1,080px short | 7,680px |\\n| Chromebook | 4 | 8 | 9:16 or 16:9 | 1,080px short | 7,680px |\\n| Wear OS | 1 | 8 | **1:1** | 384x384 | 3,840px |\\n| Android TV | 1 | 8 | **16:9** | 1,920x1,080 | 3,840px |\\n\\n- **Recommended phone size:** 1080x1920 (portrait)\\n- **Format:** JPEG or 24-bit PNG (no alpha)\\n- **Max file size:** 8 MB each\\n\\n**Note:** Google Play max is 8 screenshots per device, not 10 like Apple.\\n\\n## Feature Graphic\\n\\n- **Dimensions:** 1024 x 500 px (exact, required)\\n- **Format:** JPEG or 24-bit PNG (no alpha)\\n- Displayed at top of listing and in featured placements\\n\\n## App Icon\\n\\n- **Dimensions:** 512 x 512 px\\n- **Format:** 32-bit PNG (with alpha)\\n- **Max file size:** 1,024 KB\\n- **Shape:** Full square (Google applies 30% corner radius automatically)\\n- **Prohibited:** Ranking claims, download counts, deal text, emoji\\n\\n## Preview Video\\n\\n- **Format:** YouTube URL (public or unlisted)\\n- **Duration:** 30 seconds to 2 minutes recommended\\n- No ads, no monetization, must be embeddable, not age-restricted\\n- **Does NOT autoplay** (only ~6% of visitors tap to play)\\n\\n## Store Listing Experiments (A/B Testing)\\n\\n- **Variants:** Up to 3 per experiment (plus control)\\n- **Testable:** Icon, feature graphic, screenshots, video, short description, full description\\n- **Concurrent:** Cannot run more than 1 default graphics experiment simultaneously\\n- **Audience:** Signed-in Google Play users only\\n- **Metrics:** First-time installers + retained first-time installers (1-day retention)\\n- **Duration:** Run at least 7 days (weekday/weekend variance)\\n- **Localized:** Test across up to 5 languages simultaneously\\n\\n## Custom Store Listings\\n\\n- **Max:** 50 per app (100 for Play partners)\\n- **Customizable:** Title, short/full description, icon, screenshots, feature graphic, video\\n- **Targeting:** Country/region, pre-registration, install state, Google Ads campaigns, inactive/churned users (28+ days)\\n- **2025 addition:** Gemini AI auto-generates text for CSLs in Play Console\\n\\n## Promotional Content (LiveOps)\\n\\n| Type | Description | Duration |\\n| ----------------- | ------------------------------ | -------------------- |\\n| Offers | Discounts, free items, bundles | Up to 28 days |\\n| Events | Time-limited in-app events | Must have time limit |\\n| Major Update | Significant new features | Max 1 week |\\n| Crossover (games) | Cross-game/IP collaboration | Varies |\\n\\n- Submit **4+ days** before start (standard review)\\n- Submit **14+ days** before for featuring requests\\n- **Impact:** \\\"Over twice as many explore acquisitions during featuring\\\" (official Google)\\n\\n## Android Vitals — Ranking Thresholds\\n\\nApps exceeding these thresholds get **reduced visibility** in search and recommendations.\\n\\n| Metric | Overall Threshold | Per-Device Threshold |\\n| ---------------------------- | ----------------- | -------------------- |\\n| User-Perceived Crash Rate | **1.09%** | 8% |\\n| User-Perceived ANR Rate | **0.47%** | 8% |\\n| Excessive Partial Wake Locks | 5% | N/A |\\n\\n**Consequences:** Reduced search visibility, warning labels on listing, quality alerts to users before install.\\n**Recovery:** Google checks daily using 28-day rolling average.\\n\\n## Search Ranking — Official Factors\\n\\nGoogle confirms these affect ranking:\\n\\n1. **Metadata relevance** — Title carries most weight. NLP scans title + short desc + full desc.\\n2. **App quality** — Android Vitals (crash/ANR rates)\\n3. **Ratings and reviews** — Star rating + review text. 85% of featured apps have 4.0+\\n4. **Install volume and velocity** — Total installs + daily/weekly frequency\\n5. **Engagement and retention** — Session frequency, duration, retention rates\\n6. **Update frequency** — Regular updates signal active maintenance\\n7. **Localization** — Regional keyword/visual adaptation. 59% of US apps localize titles.\\n\\nSources: support.google.com/googleplay/android-developer/answer/4448378,\\nsupport.google.com/googleplay/android-developer/answer/9898842,\\ndeveloper.android.com/topic/performance/vitals\\n\"},\n {\"skill\":\"aso\",\"ref\":\"report-template\",\"body\":\"# ASO Audit Report Template\\n\\nUse this structure for all ASO audit reports.\\n\\n---\\n\\n## Header\\n\\n```\\n# ASO Audit: {App Name}\\n**Store:** {Apple App Store / Google Play}\\n**URL:** {listing URL}\\n**Audit date:** {date}\\n**Brand tier:** {Dominant / Established / Challenger} — {one-line justification}\\n**Overall Score:** {score}/100 (Grade: {A/B/C/D/F})\\n```\\n\\n---\\n\\n## Score Card\\n\\n```\\n| Dimension | Score | Grade | Key Issue |\\n|-----------|-------|-------|-----------|\\n| Title & Subtitle | X/10 | {grade} | {one-line summary} |\\n| Description | X/10 | {grade} | {one-line summary} |\\n| Visual Assets | X/10 | {grade} | {one-line summary} |\\n| Ratings & Reviews | X/10 | {grade} | {one-line summary} |\\n| Metadata & Freshness | X/10 | {grade} | {one-line summary} |\\n| Conversion Signals | X/10 | {grade} | {one-line summary} |\\n| **OVERALL** | **{weighted}/100** | **{grade}** | |\\n```\\n\\nGrade scale per dimension: 9-10 = A, 7-8 = B, 5-6 = C, 3-4 = D, 1-2 = F\\n\\n---\\n\\n## Top 3 Quick Wins\\n\\nHighest-impact changes that take under 1 hour:\\n\\n```\\n### 1. {Action verb} — {specific change}\\n**Impact:** {High/Medium} | **Effort:** {<15 min / <30 min / <1 hour}\\n**Current:** {what it is now}\\n**Recommended:** {exact replacement, with character count}\\n**Why:** {one sentence explaining the impact}\\n\\n### 2. ...\\n### 3. ...\\n```\\n\\n---\\n\\n## Detailed Findings\\n\\n### Title & Subtitle Analysis\\n\\n```\\n**Current title:** \\\"{title}\\\" ({X}/30 chars used)\\n**Current subtitle/short desc:** \\\"{subtitle}\\\" ({X}/30 or /80 chars used)\\n\\n**Issues found:**\\n- {issue 1}\\n- {issue 2}\\n\\n**Recommended title:** \\\"{new title}\\\" ({X}/30 chars) — {rationale}\\n**Recommended subtitle:** \\\"{new subtitle}\\\" ({X}/30 or /80 chars) — {rationale}\\n```\\n\\n### Description Analysis\\n\\n```\\n**First 3 lines (above fold):**\\n> {quoted text}\\n\\n**Issues found:**\\n- {issue 1}\\n- {issue 2}\\n\\n**Keyword density (Google Play only):** {X}% — target: 2-3%\\n**Top keywords found:** {keyword1} (Xn), {keyword2} (Xn), ...\\n**Missing high-value keywords:** {keyword1}, {keyword2}, ...\\n\\n**Recommended first 3 lines:**\\n> {rewritten text}\\n```\\n\\n### Visual Assets Analysis\\n\\n```\\n**Screenshots:** {count} ({store} shows first {3/all} in search)\\n**Preview video:** {Yes/No}\\n**Icon assessment:** {description}\\n**Feature graphic (Google Play):** {Yes/No}\\n\\n**Screenshot audit:**\\n1. {screenshot 1 description} — {pass/issue}\\n2. {screenshot 2 description} — {pass/issue}\\n...\\n\\n**Recommendations:**\\n- {specific visual change 1}\\n- {specific visual change 2}\\n```\\n\\n### Ratings & Reviews Analysis\\n\\n```\\n**Average rating:** {X.X} stars ({count} ratings)\\n**Recent review sentiment:** {Positive/Mixed/Negative}\\n**Common complaints:** {theme1}, {theme2}\\n**Developer responses:** {Yes, active / Sporadic / None}\\n\\n**Recommendations:**\\n- {specific action 1}\\n- {specific action 2}\\n```\\n\\n### Metadata & Freshness\\n\\n```\\n**Last updated:** {date} ({X days/months ago})\\n**Localizations:** {count} languages\\n**Category:** {current category}\\n**In-app events/LiveOps:** {Yes/No}\\n\\n**Recommendations:**\\n- {specific action 1}\\n- {specific action 2}\\n```\\n\\n### Conversion Signals\\n\\n```\\n**Price model:** {Free / Freemium / Paid}\\n**IAP count:** {count}\\n**Downloads (Google Play):** {range}\\n**Social proof visible:** {awards, press, badges — or \\\"none\\\"}\\n\\n**Recommendations:**\\n- {specific action 1}\\n- {specific action 2}\\n```\\n\\n---\\n\\n## Keyword Suggestions\\n\\n```\\n| Keyword | Rationale | Where to Place | Priority |\\n|---------|-----------|----------------|----------|\\n| {keyword} | {why this keyword} | {title/subtitle/description/keyword field} | {High/Med/Low} |\\n| ... | ... | ... | ... |\\n```\\n\\nNote: Without paid ASO tools, exact search volume is unavailable. These\\nsuggestions are based on category analysis, competitor metadata, and semantic\\nrelevance. Validate with AppTweak, Sensor Tower, or MobileAction for volume data.\\n\\n---\\n\\n## Competitor Comparison (if applicable)\\n\\n```\\n| Metric | {Your App} | {Competitor 1} | {Competitor 2} |\\n|--------|-----------|----------------|----------------|\\n| Title keywords | ... | ... | ... |\\n| Rating | ... | ... | ... |\\n| Screenshots | ... | ... | ... |\\n| Video | ... | ... | ... |\\n| Description keywords | ... | ... | ... |\\n| Last updated | ... | ... | ... |\\n| Overall ASO score | ... | ... | ... |\\n```\\n\\n---\\n\\n## Priority Action Plan\\n\\nOrdered by impact (high to low), grouped by effort:\\n\\n```\\n### Do This Week (Quick Wins)\\n1. {action} — {expected impact}\\n2. {action} — {expected impact}\\n\\n### Do This Month (Medium Effort)\\n3. {action} — {expected impact}\\n4. {action} — {expected impact}\\n\\n### Plan for Next Quarter (High Effort)\\n5. {action} — {expected impact}\\n6. {action} — {expected impact}\\n```\\n\\n---\\n\\n## Limitations\\n\\nAlways include this section:\\n\\n> **What this audit cannot measure without paid ASO tools:**\\n>\\n> - Exact keyword search volume and difficulty scores\\n> - Historical keyword ranking positions\\n> - Download and revenue estimates\\n> - Apple keyword field contents (hidden from public view)\\n> - Install conversion rate data (only available to app owner in console)\\n> - A/B test results from previous experiments\\n>\\n> For these data points, consider using AppTweak ($69/mo), Sensor Tower, or\\n> MobileAction ($69/mo).\\n\"},\n {\"skill\":\"aso\",\"ref\":\"scoring-criteria\",\"body\":\"# ASO Scoring Criteria\\n\\nScore each dimension 0-10 using the rubrics below.\\n**Apply brand maturity tier adjustments** from Phase 1.5 of the main skill.\\n\\n---\\n\\n## Brand Maturity Adjustments (apply to all dimensions)\\n\\nBefore scoring, determine the app's tier: **Dominant**, **Established**, or **Challenger**.\\n\\n**Dominant apps (Instagram, Uber, Spotify, WhatsApp, Netflix):**\\n\\n- Brand-only titles score 8+ (the brand IS the keyword)\\n- Lifestyle/brand screenshots score same as captioned UI screenshots\\n- Generic What's New at weekly+ cadence scores 8+\\n- Missing in-app events for utility apps is not a penalty\\n- Description scored on conversion quality only, not keyword presence\\n- Localization scored relative to actual market footprint\\n- Missing preview video is acceptable if brand awareness is near-universal\\n\\n**Established apps (Duolingo, Strava, Notion, Calm, Cash App):**\\n\\n- Brand-first titles with 1-2 keywords score normally\\n- Strategic description/visual choices get benefit of the doubt\\n- All other dimensions scored normally\\n\\n**Challenger apps (most apps):**\\n\\n- Scored strictly against textbook ASO — every character and feature matters\\n\\n**Key principle:** Before docking points, ask: \\\"Is this a mistake or a data-informed\\nchoice by a team with more information than I have?\\\"\\n\\n---\\n\\n## 1. Title & Subtitle (Weight: 20%)\\n\\n**Challenger rubric:**\\n\\n| Score | Criteria |\\n| ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\\n| 9-10 | Brand + high-value keyword in title, complementary keywords in subtitle, no word repetition across fields, near max character usage, instantly communicates app purpose |\\n| 7-8 | Good keyword presence, minor character waste (5+ unused chars), clear purpose |\\n| 5-6 | Has keywords but poor placement, some repetition between fields, purpose somewhat clear |\\n| 3-4 | Title is brand-only or generic, subtitle missing or weak, poor character usage |\\n| 1-2 | No keyword strategy, title doesn't communicate purpose, major character waste |\\n| 0 | Cannot assess (data unavailable) |\\n\\n**Dominant/Established adjustment:** Brand-only titles (e.g., \\\"Instagram\\\") are\\nvalid if the brand has high search volume. Score 8+ for Dominant apps where\\nbrand recognition eliminates the need for generic keywords. Evaluate whether\\nunused characters represent waste or intentional simplicity.\\n\\n**Check for:**\\n\\n- Characters used vs limit (title: 30, subtitle/short desc: 30/80). \\\"Near max\\\" = within 3 chars of the limit (27+/30, 77+/80)\\n- Primary keyword in title\\n- Keyword duplication between title and subtitle\\n- Whether app purpose is immediately clear\\n- Unnecessary words (articles, prepositions) consuming space\\n- Special characters or claims (\\\"#1\\\", \\\"best\\\") that risk rejection (Apple)\\n\\n---\\n\\n## 2. Description (Weight: 15%)\\n\\n### Apple App Store\\n\\n| Score | Criteria |\\n| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |\\n| 9-10 | First 3 lines hook with clear value prop, structured with features/benefits/social proof/CTA, promotional text actively used, compelling and scannable |\\n| 7-8 | Good opening, decent structure, could improve scannability or CTA |\\n| 5-6 | Generic opening (\\\"Welcome to...\\\"), some structure, missing CTA or social proof |\\n| 3-4 | Wall of text, no clear value prop above fold, no promotional text |\\n| 1-2 | Minimal or boilerplate description, no effort |\\n| 0 | Cannot assess |\\n\\n### Google Play\\n\\n| Score | Criteria |\\n| ----- | -------------------------------------------------------------------------------------------------------------------------------------------- |\\n| 9-10 | Keywords in first 3 sentences, 2-3% natural density throughout, HTML formatting used, structured sections, strong CTA, keywords feel natural |\\n| 7-8 | Good keyword presence, some structure, density slightly off (1-2% or 3-4%) |\\n| 5-6 | Keywords present but sparse (<1%) or stuffed (>5%), weak structure |\\n| 3-4 | No keyword strategy visible, poor formatting, wall of text |\\n| 1-2 | Minimal description, no keywords, no structure |\\n| 0 | Cannot assess |\\n\\n**Check for:**\\n\\n- First 3 lines quality (visible before \\\"Read More\\\")\\n- Feature-benefit framing (not just feature lists)\\n- Social proof (downloads, awards, press mentions)\\n- Call to action\\n- Keyword density (Google Play only - count target keywords / total words)\\n- HTML formatting usage (Google Play)\\n- Promotional text presence and quality (Apple)\\n\\n---\\n\\n## 3. Visual Assets (Weight: 25%)\\n\\n| Score | Criteria |\\n| ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\\n| 9-10 | 8-10 screenshots with clear messaging/captions, preview video present, screenshots tell a story in sequence, each communicates one benefit, icon is distinctive and memorable |\\n| 7-8 | 6-7 screenshots with captions, good icon, no video OR good video but some screenshot messaging unclear |\\n| 5-6 | 5+ screenshots but weak/no captions, basic icon, no video, screenshots are UI dumps |\\n| 3-4 | 3-4 screenshots, no captions, generic icon, no storytelling |\\n| 1-2 | Fewer than 3 screenshots, or screenshots are raw unedited UI, poor icon |\\n| 0 | Cannot assess |\\n\\n**Check for:**\\n\\n- Screenshot count (minimum 5, ideal 8-10)\\n- Caption/overlay text on screenshots (one message per screen, 5-7 words max)\\n- First 3 screenshots (highest conversion impact on Apple)\\n- Preview video presence and quality\\n- Icon distinctiveness (no text in icon, bold shapes, stands out)\\n- Feature graphic presence (Google Play - mandatory for featured placements)\\n- Screenshot storytelling flow (do they tell a coherent story?)\\n- Localized visual assets (for non-English markets)\\n- Caption keywords (Apple - indexed since June 2025)\\n\\n---\\n\\n## 4. Ratings & Reviews (Weight: 20%)\\n\\n| Score | Criteria |\\n| ----- | ------------------------------------------------------------------------------------------------------ |\\n| 9-10 | 4.5+ stars, 10K+ ratings, recent reviews positive, developer responds to negatives, steady review flow |\\n| 7-8 | 4.0-4.4 stars, 1K+ ratings, mostly positive recent reviews, some developer responses |\\n| 5-6 | 3.5-3.9 stars, 500+ ratings, mixed recent reviews, no developer responses |\\n| 3-4 | 3.0-3.4 stars, <500 ratings, negative themes in recent reviews |\\n| 1-2 | Below 3.0 stars, few ratings, no developer engagement, visible complaints |\\n| 0 | No ratings yet or cannot assess |\\n\\n**Check for:**\\n\\n- Average rating (target: 4.0+ minimum, 4.5+ ideal)\\n- Total rating count\\n- Recent review sentiment (last 5-10 visible reviews)\\n- Common complaint themes (bugs, crashes, pricing, UX)\\n- Developer response presence and quality\\n- Rating trend (improving or declining, if visible)\\n- Review recency (fresh reviews signal active user base)\\n\\n---\\n\\n## 5. Metadata & Freshness (Weight: 10%)\\n\\n| Score | Criteria |\\n| ----- | ------------------------------------------------------------------------------------------------------------------------- |\\n| 9-10 | Updated within last month, 10+ localizations, optimal category choice, in-app events/LiveOps active, data safety complete |\\n| 7-8 | Updated within 2 months, 5+ localizations, good category, data safety present |\\n| 5-6 | Updated within 3 months, 2-4 localizations, acceptable category |\\n| 3-4 | Updated 3-6 months ago, 1-2 localizations, possibly wrong category |\\n| 1-2 | Not updated in 6+ months, single language, poor category choice |\\n| 0 | Cannot assess |\\n\\n**Check for:**\\n\\n- Last update date and recency\\n- Number of supported languages/localizations\\n- Category selection (is it the best fit? less competitive alternative?)\\n- In-app events (Apple) or promotional content (Google) presence\\n- Data safety / privacy nutrition label completeness\\n- Age rating appropriateness\\n- Version history quality (do release notes communicate value?)\\n- What's New text quality\\n\\n---\\n\\n## 6. Conversion Signals (Weight: 10%)\\n\\n| Score | Criteria |\\n| ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\\n| 9-10 | Clear value before download, transparent pricing/IAP, social proof visible (press, awards), download range suggests strong traction, developer credibility strong |\\n| 7-8 | Good value communication, pricing clear, some social proof |\\n| 5-6 | Value prop exists but weak, pricing unclear or IAP heavy, limited social proof |\\n| 3-4 | Unclear what user gets, confusing pricing, no social proof, low downloads visible |\\n| 1-2 | No value communication, suspicious pricing, app looks abandoned |\\n| 0 | Cannot assess |\\n\\n**Check for:**\\n\\n- Price transparency (free, freemium, paid - is it clear?)\\n- In-app purchase list quality (do IAP names communicate value?)\\n- Download range (Google Play - 10K+, 100K+, 1M+ signals trust)\\n- Developer name/brand recognition\\n- \\\"Editors' Choice\\\" or featured badges\\n- Press mentions or awards in description\\n- Related apps from same developer (portfolio trust signal)\\n- Privacy practices transparency\\n\\n---\\n\\n## Calculating Final Score\\n\\n```\\nFinal Score = (Title * 0.20) + (Description * 0.15) + (Visuals * 0.25)\\n + (Ratings * 0.20) + (Metadata * 0.10) + (Conversion * 0.10)\\n\\nScale to 100: Final Score * 10\\n```\\n\\n**Example:** Title: 7, Description: 6, Visuals: 8, Ratings: 9, Metadata: 5, Conversion: 7\\n\\n```\\n(7 * 0.20) + (6 * 0.15) + (8 * 0.25) + (9 * 0.20) + (5 * 0.10) + (7 * 0.10)\\n= 1.4 + 0.9 + 2.0 + 1.8 + 0.5 + 0.7\\n= 7.3 → 73/100 → Grade: B\\n```\\n\"},\n {\"skill\":\"churn-prevention\",\"ref\":\"cancel-flow-patterns\",\"body\":\"# Cancel Flow Patterns\\n\\nDetailed cancel flow patterns by business type, billing provider, and industry.\\n\\n---\\n\\n## Cancel Flow by Business Type\\n\\n### B2C / Self-Serve SaaS\\n\\nHigh volume, low touch. The flow must work without human intervention.\\n\\n**Flow structure:**\\n```\\nCancel button → Exit survey (1 question) → Dynamic offer → Confirm → Post-cancel\\n```\\n\\n**Characteristics:**\\n- Fully automated, no human in the loop\\n- Quick — 2-3 screens maximum\\n- One offer + one fallback, not a menu of options\\n- Mobile-optimized (significant cancellations on mobile)\\n- Clear \\\"continue cancelling\\\" at every step\\n\\n**Typical save rate:** 20-30%\\n\\n**Example flow for a $29/mo productivity app:**\\n1. \\\"What's the main reason?\\\" → 6 options\\n2. Selected \\\"Too expensive\\\" → \\\"Get 25% off for 3 months (save $21.75)\\\"\\n3. Declined → \\\"Or switch to our Starter plan at $12/mo\\\"\\n4. Declined → \\\"We're sorry to see you go. Your access continues until [date].\\\"\\n\\n---\\n\\n### B2B / Team Plans\\n\\nLower volume, higher stakes. Personal outreach is worth the cost.\\n\\n**Flow structure:**\\n```\\nCancel button → Exit survey → Offer (or route to CS) → Confirm → Post-cancel\\n```\\n\\n**Characteristics:**\\n- Route accounts above MRR threshold to customer success\\n- Show team impact (\\\"Your 8 team members will lose access\\\")\\n- Offer admin-to-admin call for enterprise accounts\\n- Longer consideration — allow \\\"schedule a call\\\" as a save option\\n- Require admin/owner role to cancel (not any team member)\\n\\n**Typical save rate:** 30-45% (higher because of personal touch)\\n\\n**MRR-based routing:**\\n\\n| Account MRR | Cancel Flow |\\n|-------------|-------------|\\n| <$100/mo | Automated flow with offers |\\n| $100-$500/mo | Automated + flag for CS follow-up |\\n| $500-$2,000/mo | Route to CS before cancel completes |\\n| $2,000+/mo | Block self-serve cancel, require CS call |\\n\\n---\\n\\n### Freemium / Free-to-Paid\\n\\nUsers cancelling paid to return to free tier. Different psychology — they're not leaving, they're downgrading.\\n\\n**Flow structure:**\\n```\\nCancel button → \\\"Switch to Free?\\\" prompt → Exit survey (if still cancelling) → Offer → Confirm\\n```\\n\\n**Characteristics:**\\n- Lead with the free tier as the first option (not a save offer)\\n- Show what they keep on free vs. what they lose\\n- The \\\"save\\\" is keeping them on free, not losing them entirely\\n- Track free-tier users for future re-upgrade campaigns\\n\\n---\\n\\n## Cancel Flow by Billing Interval\\n\\n### Monthly Subscribers\\n\\n- More price-sensitive, shorter commitment\\n- Discount offers work well (20-30% for 2-3 months)\\n- Pause is effective (1-2 months)\\n- Suggest annual plan at a discount as an alternative\\n\\n**Offer priority:**\\n1. Discount (if reason = price)\\n2. Pause (if reason = not using / temporary)\\n3. Annual plan switch (if engaged but price-sensitive)\\n\\n### Annual Subscribers\\n\\n- Higher commitment, often cancelling for stronger reasons\\n- Prorate refund expectations matter\\n- Longer save window (they've already paid)\\n- Personal outreach more justified (higher LTV at stake)\\n\\n**Offer priority:**\\n1. Pause remainder of term (if temporary)\\n2. Plan adjustment + credit for next renewal\\n3. Personal outreach from CS\\n4. Partial refund + downgrade (better than full refund + cancel)\\n\\n**Refund handling:**\\n- Offer prorated refund if significant time remaining\\n- \\\"Pause until renewal\\\" if less than 3 months left\\n- Be generous — bad refund experiences create vocal detractors\\n\\n---\\n\\n## Save Offer Patterns\\n\\n### The Discount Ladder\\n\\nDon't lead with your biggest discount. Escalate:\\n\\n```\\nCancel click → 15% off → Still cancelling → 25% off → Still cancelling → Let them go\\n```\\n\\n**Rules:**\\n- Maximum 2 discount offers per cancel session\\n- Never exceed 30% (higher trains cancel-for-discount behavior)\\n- Time-limit discounts (2-3 months, then full price resumes)\\n- Track discount accepters — if they cancel again at full price, don't re-offer\\n\\n### The Pause Playbook\\n\\nPause is often better than a discount because it doesn't devalue your product.\\n\\n**Implementation:**\\n\\n| Setting | Recommendation |\\n|---------|---------------|\\n| Pause duration options | 1 month, 2 months, 3 months |\\n| Default selection | 1 month (shortest) |\\n| Maximum pause | 3 months (longer pauses rarely return) |\\n| During pause | Keep data, remove access |\\n| Reactivation | Auto-reactivate with 7-day advance email |\\n| Repeat pauses | Allow 1 pause per 12-month period |\\n\\n**Pause reactivation sequence:**\\n- Day -7: \\\"Your pause ends in 7 days. We've been busy — here's what's new.\\\"\\n- Day -1: \\\"Welcome back tomorrow! Here's what's waiting for you.\\\"\\n- Day 0: \\\"You're back! Here's a quick tour of what's new.\\\"\\n\\n### The Downgrade Path\\n\\nFor multi-plan products, downgrade is the strongest save:\\n\\n```\\n┌─────────────────────────────────────────┐\\n│ Before you go, what about right-sizing │\\n│ your plan? │\\n│ │\\n│ Current: Pro ($49/mo) │\\n│ │\\n│ ┌─────────────────────────────────┐ │\\n│ │ Switch to Starter ($19/mo) │ │\\n│ │ │ │\\n│ │ ✓ Keep: Projects, integrations │ │\\n│ │ ✗ Lose: Advanced analytics, │ │\\n│ │ team features │ │\\n│ │ │ │\\n│ │ [Switch to Starter] │ │\\n│ └─────────────────────────────────┘ │\\n│ │\\n│ [No thanks, continue cancelling] │\\n└─────────────────────────────────────────┘\\n```\\n\\n**Downgrade best practices:**\\n- Show exactly what they keep and what they lose\\n- Use checkmarks and X marks for scanability\\n- Preserve their data even on the lower plan\\n- If they downgrade, don't show upgrade prompts for at least 30 days\\n\\n### The Competitor Switch Handler\\n\\nWhen the cancel reason is \\\"switching to competitor\\\":\\n\\n1. **Ask which competitor** (optional, don't force it)\\n2. **Show a comparison** if you have one (see competitors skill)\\n3. **Offer a migration credit** (\\\"We'll match their price for 3 months\\\")\\n4. **Request a feedback call** (\\\"15 minutes to understand what we're missing\\\")\\n\\nThis data is gold for product and marketing teams.\\n\\n---\\n\\n## Post-Cancel Experience\\n\\nWhat happens after cancel matters for:\\n- Win-back potential\\n- Word of mouth\\n- Review sentiment\\n\\n### Confirmation Page\\n\\n```\\nYour subscription has been cancelled.\\n\\nWhat happens next:\\n• Your access continues until [billing period end date]\\n• Your data will be preserved for 90 days\\n• You can reactivate anytime from your account settings\\n\\n[Reactivate My Account]\\n\\nWe'd love to have you back. We'll keep improving based on feedback\\nfrom customers like you.\\n```\\n\\n### Post-Cancel Sequence\\n\\n| Timing | Action |\\n|--------|--------|\\n| Immediately | Confirmation email with access end date |\\n| Day 1 | (Nothing — don't be desperate) |\\n| Day 7 | NPS/satisfaction survey about overall experience |\\n| Day 30 | \\\"What's new\\\" email with recent improvements |\\n| Day 60 | Address their specific cancel reason if resolved |\\n| Day 90 | Final win-back with special offer |\\n\\n**For detailed win-back email sequences**: See the emails skill.\\n\\n---\\n\\n## Segmentation Rules\\n\\nThe most effective cancel flows use segmentation to show different offers to different customers.\\n\\n### Segmentation Dimensions\\n\\n| Dimension | Why It Matters |\\n|-----------|---------------|\\n| Plan / MRR | Higher-value customers get personal outreach |\\n| Tenure | Long-term customers get more generous offers |\\n| Usage level | High-usage customers get different messaging than dormant ones |\\n| Billing interval | Monthly vs. annual need different approaches |\\n| Previous saves | Don't re-offer the same discount to a repeat canceller |\\n| Cancel reason | Drives which offer to show (core mapping) |\\n\\n### Segment-Specific Flows\\n\\n**New customer (< 30 days):**\\n- They haven't activated. The save is onboarding, not discounts.\\n- Offer: Free onboarding call, setup help, extended trial\\n- Ask: \\\"What were you hoping to accomplish?\\\" (learn what's missing)\\n\\n**Engaged customer cancelling on price:**\\n- They love the product but can't justify the cost.\\n- Offer: Discount, annual plan switch, downgrade\\n- High save potential\\n\\n**Dormant customer (no login 30+ days):**\\n- They forgot about you. A discount won't bring them back.\\n- Offer: Pause subscription, \\\"what changed?\\\" conversation\\n- Low save potential — focus on learning why\\n\\n**Power user switching to competitor:**\\n- They're actively choosing something else.\\n- Offer: Competitive match, feedback call, roadmap preview\\n- Medium save potential — depends on reason\\n\\n---\\n\\n## Implementation Checklist\\n\\n### Phase 1: Foundation (Week 1)\\n- [ ] Add cancel flow (survey + 1 offer + confirmation)\\n- [ ] Set up exit survey with 5-7 reason categories\\n- [ ] Map one offer per reason (simple 1:1 mapping)\\n- [ ] Track cancel reasons and save rate in analytics\\n- [ ] Enable pre-dunning card expiry emails\\n\\n### Phase 2: Optimization (Weeks 2-4)\\n- [ ] Add fallback offers (primary + secondary per reason)\\n- [ ] Implement pause subscription option\\n- [ ] Set up dunning email sequence (4 emails over 10 days)\\n- [ ] Enable smart retries (Stripe Smart Retries or equivalent)\\n- [ ] Add MRR-based routing for high-value accounts\\n\\n### Phase 3: Advanced (Month 2+)\\n- [ ] Build health score from usage signals\\n- [ ] Set up proactive intervention triggers\\n- [ ] A/B test discount amounts and offer types\\n- [ ] Segment flows by plan, tenure, and usage\\n- [ ] Post-cancel win-back sequence (coordinate with emails skill)\\n- [ ] Cohort analysis: churn by channel, plan, tenure\\n\\n---\\n\\n## Compliance Notes\\n\\n### FTC Click-to-Cancel Rule (US)\\n- Cancellation must be as easy as signup\\n- Cannot require a phone call to cancel if signup was online\\n- Cannot add excessive steps to discourage cancellation\\n- Save offers are allowed but \\\"continue cancelling\\\" must be clear\\n\\n### GDPR / Data Retention (EU)\\n- Inform users about data retention period post-cancel\\n- Offer data export before account deletion\\n- Honor deletion requests within 30 days\\n- Don't use post-cancel data for marketing without consent\\n\\n### General Best Practices\\n- Always show a clear path to complete cancellation\\n- Never hide the cancel button (dark pattern)\\n- Process cancellation even if save flow has errors\\n- Confirm cancellation with email receipt\\n\"}\n];\n",[],[463,774,816],"f9966b0a-5d6d-11f1-a415-1607ee4eb77e","ref_2.ts","f9966baa-5d6d-11f1-a415-1607ee4eb77e",661,["D",1780286234531],"// GENERATED by deploy/gen_skills_catalog.mjs — do not edit by hand.\nimport type { SkillRef } from \"../index.ts\";\nexport const REFS_PART_2: SkillRef[] = [\n {\"skill\":\"ads\",\"ref\":\"conversion-tracking\",\"body\":\"# Conversion Tracking Setup\\n\\nHow to set up conversion tracking pixels across ad platforms. This guide covers installation, event configuration, and validation — everything a marketer needs to ensure ad spend is properly attributed.\\n\\n---\\n\\n## Why This Matters\\n\\nWithout conversion tracking:\\n- Ad platforms can't optimize for your actual goals\\n- You're flying blind on ROAS and CPA\\n- Retargeting audiences can't be built\\n- You'll waste budget on impressions that don't convert\\n\\nGet tracking right before spending a dollar on ads.\\n\\n---\\n\\n## Platform Pixels Overview\\n\\n| Platform | Pixel/Tag Name | Events API | Key Events |\\n|----------|---------------|:----------:|------------|\\n| **Google Ads** | Google tag (gtag.js) | Enhanced Conversions | purchase, sign_up, generate_lead |\\n| **Meta** | Meta Pixel + CAPI | Conversions API | Purchase, Lead, ViewContent, AddToCart |\\n| **LinkedIn** | Insight Tag | Conversions API | conversion (URL or event-based) |\\n| **TikTok** | TikTok Pixel | Events API | Purchase, ViewContent, AddToCart, CompleteRegistration |\\n| **Twitter/X** | Twitter Pixel | - | Purchase, SignUp, Download |\\n\\n---\\n\\n## Google Ads\\n\\n### Install the Google tag\\n\\nAdd to every page, in ``:\\n\\n```html\\n\\n\\n```\\n\\nReplace `AW-XXXXXXXXX` with your Conversion ID from Google Ads > Tools > Conversions.\\n\\n### Set up conversion actions\\n\\nIn Google Ads > Goals > Conversions > New conversion action:\\n\\n| Conversion | Category | Value | Count |\\n|-----------|----------|-------|-------|\\n| Purchase | Purchase | Dynamic (order value) | Every |\\n| Sign up / Lead | Sign-up | Fixed ($X estimated value) | One |\\n| Demo request | Lead | Fixed ($X estimated value) | One |\\n| Free trial start | Sign-up | Fixed ($X estimated value) | One |\\n\\n### Fire conversion events\\n\\n```javascript\\n// Purchase\\ngtag('event', 'conversion', {\\n 'send_to': 'AW-XXXXXXXXX/CONVERSION_LABEL',\\n 'value': 99.00,\\n 'currency': 'USD',\\n 'transaction_id': 'ORDER-123'\\n});\\n\\n// Lead / Sign up\\ngtag('event', 'conversion', {\\n 'send_to': 'AW-XXXXXXXXX/CONVERSION_LABEL',\\n 'value': 50.00,\\n 'currency': 'USD'\\n});\\n```\\n\\n### Enhanced Conversions\\n\\nSends hashed first-party data (email, phone) to improve attribution after cookie restrictions. Enable in Google Ads > Goals > Settings > Enhanced conversions.\\n\\n```javascript\\ngtag('set', 'user_data', {\\n 'email': 'user@example.com', // auto-hashed by gtag\\n 'phone_number': '+11234567890'\\n});\\n```\\n\\n### Google Tag Manager alternative\\n\\nIf using GTM instead of inline gtag.js:\\n1. Install GTM container on all pages\\n2. Create Google Ads conversion tags in GTM\\n3. Set triggers for conversion events (form submissions, purchases)\\n4. Use the Data Layer to pass dynamic values (order amount, transaction ID)\\n5. Test with GTM Preview mode before publishing\\n\\n---\\n\\n## Meta (Facebook/Instagram)\\n\\n### Install the Meta Pixel\\n\\nAdd to every page, in ``:\\n\\n```html\\n\\n```\\n\\nReplace `YOUR_PIXEL_ID` from Meta Events Manager.\\n\\n### Standard events\\n\\n```javascript\\n// View a product or key page\\nfbq('track', 'ViewContent', {\\n content_name: 'Pro Plan',\\n content_category: 'Pricing',\\n value: 29.00,\\n currency: 'USD'\\n});\\n\\n// Lead capture (form submit, demo request)\\nfbq('track', 'Lead', {\\n content_name: 'Demo Request',\\n value: 50.00,\\n currency: 'USD'\\n});\\n\\n// Purchase\\nfbq('track', 'Purchase', {\\n value: 99.00,\\n currency: 'USD',\\n content_type: 'product',\\n contents: [{ id: 'pro-plan', quantity: 1 }]\\n});\\n\\n// Add to cart (e-commerce)\\nfbq('track', 'AddToCart', {\\n content_ids: ['SKU-123'],\\n content_type: 'product',\\n value: 49.00,\\n currency: 'USD'\\n});\\n```\\n\\n### Conversions API (CAPI)\\n\\nServer-side tracking that works alongside the pixel. Required for accurate tracking after iOS 14+ and cookie restrictions.\\n\\nSet up via:\\n- **Direct integration** — send events from your server to Meta's API\\n- **Partner integrations** — Shopify, WooCommerce, Segment, etc. have built-in CAPI support\\n- **Conversions API Gateway** — Meta's managed solution via AWS\\n\\nKey: send the same events from both pixel (browser) AND CAPI (server), with a shared `event_id` for deduplication.\\n\\n### Aggregated Event Measurement\\n\\nRequired for iOS 14+ tracking. In Events Manager > Aggregated Event Measurement:\\n1. Verify your domain\\n2. Configure and prioritize your top 8 events in order of business importance\\n3. Purchase should typically be #1, Lead #2\\n\\n---\\n\\n## LinkedIn\\n\\n### Install the Insight Tag\\n\\nAdd to every page, before ``:\\n\\n```html\\n\\n```\\n\\n### Conversion tracking\\n\\nLinkedIn supports two methods:\\n\\n**URL-based**: Fires when someone visits a specific URL (e.g., `/thank-you`).\\nSet up in Campaign Manager > Analyze > Conversion Tracking > Create Conversion.\\n\\n**Event-based**: Fire manually on specific actions:\\n\\n```javascript\\nwindow.lintrk('track', { conversion_id: YOUR_CONVERSION_ID });\\n```\\n\\n### LinkedIn CAPI\\n\\nFor server-side tracking, LinkedIn offers a Conversions API. Set up via partner integrations (Segment, Tealium) or direct API calls. Deduplicates with the Insight Tag automatically when configured correctly.\\n\\n---\\n\\n## TikTok\\n\\n### Install the TikTok Pixel\\n\\nAdd to every page, in ``:\\n\\n```html\\n\\n```\\n\\n### Standard events\\n\\n```javascript\\n// View content\\nttq.track('ViewContent', {\\n content_id: 'pro-plan',\\n content_type: 'product',\\n content_name: 'Pro Plan',\\n value: 29.00,\\n currency: 'USD'\\n});\\n\\n// Complete registration / sign up\\nttq.track('CompleteRegistration', {\\n content_name: 'Free Trial'\\n});\\n\\n// Purchase\\nttq.track('Purchase', {\\n content_id: 'pro-plan',\\n content_type: 'product',\\n value: 99.00,\\n currency: 'USD',\\n quantity: 1\\n});\\n\\n// Add to cart\\nttq.track('AddToCart', {\\n content_id: 'SKU-123',\\n content_type: 'product',\\n value: 49.00,\\n currency: 'USD'\\n});\\n```\\n\\n### Events API (server-side)\\n\\nTikTok's Events API works like Meta's CAPI — send the same events from your server for better attribution. Use `event_id` for deduplication with browser pixel events.\\n\\n### Advanced Matching\\n\\nPass hashed user data for better attribution:\\n\\n```javascript\\nttq.identify({\\n email: 'user@example.com', // auto-hashed\\n phone_number: '+11234567890'\\n});\\n```\\n\\n---\\n\\n## Validation Checklist\\n\\nAfter installing any pixel, verify before going live:\\n\\n### Browser-side checks\\n\\n- [ ] Pixel fires on every page (check via browser extension)\\n- [ ] Conversion events fire at the right moment (after confirmed action, not on button click)\\n- [ ] Event parameters contain correct values (currency, amount, content IDs)\\n- [ ] No duplicate events firing on the same action\\n- [ ] Events fire on both desktop and mobile\\n\\n### Platform-side checks\\n\\n- [ ] Events appear in the platform's event manager/diagnostics\\n- [ ] Test conversions show correct values\\n- [ ] Event match quality is acceptable (Meta: score > 6)\\n- [ ] Server-side events are deduplicating with browser events (not double-counting)\\n\\n### Debugging tools\\n\\n| Platform | Tool |\\n|----------|------|\\n| Google | Google Tag Assistant, Chrome DevTools Network tab |\\n| Meta | Meta Pixel Helper (Chrome extension), Events Manager Test Events |\\n| LinkedIn | Insight Tag Validator in Campaign Manager |\\n| TikTok | TikTok Pixel Helper (Chrome extension), Events Manager |\\n| All | GTM Preview Mode (if using Google Tag Manager) |\\n\\n---\\n\\n## Common Mistakes\\n\\n- **Firing purchase events on button click instead of confirmed payment** — always fire on the success/thank-you page or after server confirmation\\n- **Missing deduplication between pixel and server events** — without a shared `event_id`, you'll double-count conversions\\n- **Not testing on mobile** — many pixels break on mobile browsers or in-app webviews\\n- **Hardcoded test values** — remove test transaction amounts before going live\\n- **Forgetting to exclude internal traffic** — your team's visits inflate conversion data\\n- **Installing pixels without consent management** — GDPR/CCPA require user consent befor

Diff · v1003